# Rsbuild V2 Upgrade

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

- Skill: `rstackjs/rsbuild-v2-upgrade` (Agent Skill)
- Install (CLI): `npx skillmds@latest add rstackjs/rsbuild-v2-upgrade`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rstackjs/rsbuild-v2-upgrade/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: rstackjs (https://skillmd.com/u/rstackjs)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/rstackjs/rsbuild-v2-upgrade

---


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

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.