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

2. Open the official upgrade guide

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

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