Rsbuild V2 Upgrade

Handles the migration from Rsbuild 1.x to v2 by walking through dependency updates, config changes, and breaking changes. It checks your package.json and config file, references the official upgrade guide at rsbuild.rs, then bumps core and plugins using taze before applying the necessary config updates. The workflow is methodical, which matters because build tool upgrades tend to break in subtle ways if you miss renamed options or new defaults. It finishes with validation steps to catch issues early. Good for teams that want a structured path through the upgrade instead of piecing together changelogs and GitHub issues.

skills.sh installs: 493
GitHub stars: 98
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add rstackjs/agent-skills --skill rsbuild-v2-upgrade --agent claude-code

Installs into .claude/skills of the current project.

Files

Rsbuild v1 to v2 upgrade

Workflow

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.