rstackjs/agent-skills

rsbuild-v2-upgrade

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

Voir la source
Document Skill original

Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.

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.