
Rsbuild V2 Upgrade
- 396 installs
- 86 repo stars
- Updated August 4, 2026
- rstackjs/agent-skills
rsbuild-v2-upgrade is an agent skill that migrates Rsbuild 1.x projects to v2 by auditing package.json dependencies, rsbuild.config files, and breaking changes from the official upgrade guide for developers upgrading fro
About
rsbuild-v2-upgrade is an rstackjs agent skill for upgrading Rsbuild 1.x projects to Rsbuild v2 without guesswork. The workflow starts by reading package.json to list Rsbuild core and plugin packages, then locates rsbuild.config.(ts|js|mjs|cjs). It directs agents to the official v1-to-v2 guide at rsbuild.rs as the source of truth, compares the current config against documented breaking changes, and plans a migration path listing only changes that apply to the project's plugins. Developers reach for rsbuild-v2-upgrade when a monorepo or SPA hits Rsbuild v2 release notes, CI breaks after bumping @rsbuild/core, or plugin APIs changed between major versions. The skill is narrowly scoped to migration—not greenfield Rsbuild setup—so agents avoid rewriting unrelated application code.
- rsbuild-v2-upgrade
Rsbuild V2 Upgrade by the numbers
- 396 all-time installs (skills.sh)
- +15 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #1,088 of 4,347 Backend & APIs skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/rstackjs/agent-skills --skill rsbuild-v2-upgradeAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 396 |
|---|---|
| repo stars | ★ 86 |
| Last updated | August 4, 2026 |
| Repository | rstackjs/agent-skills ↗ |
How do you upgrade an Rsbuild 1.x project to v2?
Use rsbuild-v2-upgrade for development tasks
Who is it for?
Frontend developers maintaining an Rsbuild 1.x SPA or monorepo package who need a guided v2 dependency and config migration.
Skip if: Teams bootstrapping a new Rsbuild project from scratch or migrating off Webpack without an existing Rsbuild 1.x setup.
When should I use this skill?
package.json shows @rsbuild/core 1.x and the developer asks to upgrade Rsbuild, fix post-upgrade build errors, or follow the v1-to-v2 migration guide.
What you get
Migration plan, updated package.json dependencies, revised rsbuild.config file, and resolved breaking-change checklist.
- updated package.json
- migrated rsbuild.config
- breaking-change checklist
By the numbers
- Supports rsbuild.config.ts, .js, .mjs, and .cjs config file extensions
- Three-step workflow: confirm setup, open official guide, plan upgrade path
Files
Rsbuild v1 to v2 Upgrade
Workflow
1. Confirm current setup
- Read
package.jsonto 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/coreto 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.
Related skills
How it compares
Use rsbuild-v2-upgrade for in-place Rsbuild major bumps; use framework-specific upgrade skills when the blocker is React or Next.js rather than the bundler itself.
FAQ
What files does rsbuild-v2-upgrade inspect first?
rsbuild-v2-upgrade starts with package.json to identify Rsbuild and plugin package versions, then locates rsbuild.config.(ts|js|mjs|cjs) before comparing against the official v1-to-v2 upgrade guide.
Where is the Rsbuild v2 migration source of truth?
rsbuild-v2-upgrade points agents to https://rsbuild.rs/guide/upgrade/v1-to-v2 for breaking changes, plugin updates, and config renames rather than improvising migration steps.