#Upgrade Rslib

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

#Semantic versioning

Rslib 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 Releases to view the changes for each version of Rslib.

#Using taze

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

#Usage

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

npx taze --include "/(rsbuild|rslib)/" -w

The result will look similar to:

rslib - 2 minor

  @rslib/core                 dev  ~1mo  ^1.0.0  →  ^1.1.0
  @rsbuild/plugin-react       dev  ~1mo  ^2.0.0  →  ^2.1.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 @rslib scope:

npx taze --include /@rslib/ -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|rslib)/" -w -r

• Add -l to upgrade locked versions:

npx taze --include "/(rsbuild|rslib)/" -w -l

• To upgrade to a major version:

npx taze major --include "/(rsbuild|rslib)/" -w

For more options, please refer to the taze documentation.