mcpField
R
rsbuild-v2-upgrade

rsbuild-v2-upgrade

github.com/rstackjsDevelopment97479 installsUpdated 6d ago
Repository

About rsbuild-v2-upgrade

rsbuild-v2-upgrade is a migration skill for upgrading Rsbuild projects from v1 to v2. It guides configuration and dependency review, breaking-change planning, code updates, and build and test validation.

Key features

  1. 01Inspect package and Rsbuild configuration
  2. 02Consult the official upgrade guide
  3. 03Identify applicable breaking changes
  4. 04Update Rsbuild dependencies and plugins
  5. 05Adjust configuration and code
  6. 06Validate builds and tests

Use cases

  1. 01Planning an Rsbuild v1 to v2 migration
  2. 02Finding config options affected by the upgrade
  3. 03Updating Rsbuild plugins and dependencies
  4. 04Checking a migration with builds and tests

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/rstackjs/agent-skills --skill rsbuild-v2-upgrade

After installing, type/rsbuild-v2-upgradein Claude Code to confirm it loaded.

Details

From the project README

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

  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.

  4. Update dependencies

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

  5. Apply config and code changes

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

  6. Validate

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

Comments

Markdown supported