Nx with Rsbuild

Rsbuild is an Rspack-based build tool for web applications. In an Rsbuild monorepo, Nx lets you build, serve, and cache every project from a single workspace.

The Nx Plugin for Rsbuild contains executors and generators that support building applications using Rsbuild, wiring each project into Nx.

Requirements

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

Package	Supported Versions	Default Installed
@rsbuild/core	^1.0.0 || ^2.0.0	2.0.6

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.

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.