#Upgrading Rsbuild

This section explains how to upgrade your project's Rsbuild dependencies to the latest version.

#Semantic versioning

Rsbuild follows the Semantic Versioning specification.

• Major version: contains incompatible API changes.
• Minor version: contains backward compatible features and fixes.
• Patch version: contains backward compatible bug fixes.

#Changelog

Visit GitHub - release to view the changes for each version of Rsbuild.

#Using taze

We recommend using Taze to upgrade the Rsbuild version. Taze is a CLI tool for updating npm dependencies.

#Usage

Run the following command to upgrade all dependencies that include rsbuild in their names:

npx taze --include /rsbuild/ -w

The result will look similar to:

rsbuild - 3 patch

  @rsbuild/core               dev  ~1mo  ^1.0.0  →  ^1.2.0
  @rsbuild/plugin-react       dev  ~1mo  ^1.0.0  →  ^1.2.0
  @rsbuild/plugin-type-check  dev  ~1mo  ^1.0.0  →  ^1.2.0

ℹ changes written to package.json, run npm i to install updates.

You can also adjust the include pattern to match specific packages. For example, to upgrade only packages under the @rsbuild scope:

npx taze --include /@rsbuild/ -w

#Options

Here are some examples of using Taze options:

• In a monorepo, you can add the -r option to upgrade recursively:

npx taze --include /rsbuild/ -w -r

• Add -l to upgrade locked versions:

npx taze --include /rsbuild/ -w -l

• To upgrade to a major version:

npx taze major --include /rsbuild/ -w

For more options, please refer to the taze documentation.