Nx with Rsbuild

The Nx Plugin for Rsbuild contains executors and generators that support building applications using Rsbuild. In an Rsbuild monorepo, it wires each project into Nx so you can build, serve, and cache them from a single workspace.

Requirements

The @nx/rsbuild plugin supports the following package versions.

Package	Supported Versions	Default Installed
@rsbuild/core	^1.0.0	1.1.10

Nx generators install the latest supported version automatically when scaffolding new projects. When @rsbuild/core is already installed in your workspace, generators detect the installed version and keep it in place rather than overwriting it.

@rsbuild/core v2 not yet supported

@rsbuild/core@2 ships as a pure-ESM package, which @nx/rsbuild (CommonJS) cannot currently load synchronously. Support is tracked separately; until then, pin @rsbuild/core to ^1.

Setting up @nx/rsbuild

Installation

Keep Nx Package Versions In Sync

Make sure to install the @nx/rsbuild version that matches the version of nx in your repository. If the version numbers get out of sync, you can encounter some difficult to debug errors. You can fix Nx version mismatches with this recipe.

In any Nx workspace, you can install @nx/rsbuild by running the following command:

nx add @nx/rsbuild

This will install the correct version of @nx/rsbuild.

Using @nx/rsbuild

Generate a new project using Rsbuild

You can generate a new application that uses Rsbuild with the following command:

nx g @nx/react:app myapp --bundler=rsbuild

This will create a new application configured to use Rsbuild for building.

Set up CI for your Rsbuild monorepo

In CI, Nx runs nx affected to rebuild and retest only the projects a change touches, and caches results to skip repeated work.

For a complete pipeline, see Set up CI.