> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# Upgrade Rslib

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

:::tip

See [npm - @rslib/core](https://npmjs.com/package/@rslib/core) to view the latest version.

:::

## Semantic versioning

Rslib follows the [Semantic Versioning](https://semver.org/) 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](https://github.com/web-infra-dev/rslib/releases) to view the changes for each version of Rslib.

## Using taze

We recommend using [Taze](https://github.com/antfu-collective/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:

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

The result will look similar to:

```bash
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:

```bash
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:

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

- Add `-l` to upgrade locked versions:

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

- To upgrade to a major version:

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

> For more options, please refer to the [taze documentation](https://github.com/antfu-collective/taze).