Agent-Skills.md

Agent Skills: Rsbuild v1 to v2 Upgrade

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

UncategorizedID: rstackjs/agent-skills/rsbuild-v2-upgrade

Repository

rstackjs/agent-skills
rstackjsLicense: MIT
50

Install this agent skill to your local

pnpm dlx add-skill https://github.com/rstackjs/agent-skills/tree/HEAD/skills/rsbuild-v2-upgrade

Skill Files

Browse the full folder contents for rsbuild-v2-upgrade.

Download Skill

Loading file tree…

skills/rsbuild-v2-upgrade/SKILL.md

Skill Metadata

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

  2. Open the official upgrade guide

    • Use the v1 → v2 guide as the source of truth:
      • https://v2.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.

  4. Update dependencies

    • Bump @rsbuild/core to v2 (currently rc tag).
    • 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.