version: "1.0.1" name: rsbuild-v2-upgrade description: Use when upgrading a Rsbuild 1.x project to v2, including dependency and configuration updates.

Rsbuild v1 to v2 Upgrade

Workflow

1. 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)).

1. Open the official upgrade guide

• Use the v1 → v2 guide as the source of truth:
• https://rsbuild.rs/guide/upgrade/v1-to-v2

1. 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.

1. Update dependencies

• Bump @rsbuild/core to v2
• Bump Rsbuild plugins to latest versions via npx taze major --include /rsbuild/ -w -r

1. Apply config and code changes

• Update the Rsbuild config to match v2 options and defaults.
• Remove deprecated or unsupported settings.

1. Validate

• Run the build and dev commands.
• Run project tests or type checks.
• Fix any warnings or errors surfaced by the new version.