Rsbuild V2 Upgrade

by rstackjs2966acbef746No license95 starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated today

Use when upgrading a Rsbuild 1.x project to v2, including dependency and configuration updates.

AI-generated overview

Guides upgrading a Rsbuild 1.x project to v2, covering dependency bumps and configuration changes.

What it does: This skill walks an agent through migrating a Rsbuild 1.x project to Rsbuild v2. It inspects package.json and the Rsbuild config file, compares the project against the official v1-to-v2 upgrade guide, and lists applicable breaking changes. It then bumps @rsbuild/core and Rsbuild plugins, updates configuration and code, and validates by running build, dev, tests, or type checks.
When to use it: Use it when a project still runs Rsbuild 1.x and needs to move to v2. It fits maintenance work where dependencies, plugin versions, and configuration options must be brought in line with the new major version.
Requirements: No scripts ship with the skill; it is instructions only. It needs access to the project's package.json and Rsbuild config file, a package manager or npx for dependency updates, and network access to consult the official Rsbuild upgrade guide.

Rsbuild v1 to v2 upgrade

Confirm current setup
- Read package.json to identify Rsbuild and plugin packages in use.
- Locate the Rsbuild config file (commonly rsbuild.config.(ts|js|mjs|cjs)).
Open the official upgrade guide
- Use the v1 → v2 guide as the source of truth:
  - https://rsbuild.rs/guide/upgrade/v1-to-v2
Plan the upgrade path
- Compare the current project config with the migration guide.
- List breaking changes that apply to the project’s current config and plugins.
- Note any removed or renamed options, defaults, or plugin APIs.
Update dependencies
- Bump @rsbuild/core to v2
- Bump Rsbuild plugins to latest versions via npx taze major --include /rsbuild/ -w -r
Apply config and code changes
- Update the Rsbuild config to match v2 options and defaults.
- Remove deprecated or unsupported settings.
Validate
- Run the build and dev commands.
- Run project tests or type checks.
- Fix any warnings or errors surfaced by the new version.

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.