
Rspack V2 Upgrade
- 431 installs
- 86 repo stars
- Updated August 4, 2026
- rstackjs/agent-skills
rspack-v2-upgrade is an agent skill that migrates Rspack 1.x projects to v2 by updating dependencies and configuration for developers upgrading frontend bundler pipelines.
About
rspack-v2-upgrade is an rstackjs/agent-skills workflow for upgrading Rspack 1.x projects to Rspack v2. The process starts by reading package.json to identify Rspack packages, then locates the config file—commonly rspack.config.ts, rspack.config.js, rspack.config.mjs, or rspack.config.cjs. It uses the official migration guide at rspack.rs/guide/migration/rspack_1.x as the single source of truth, comparing the current config against documented breaking changes and affected plugins. The skill plans required dependency bumps and config edits before applying them. Developers reach for rspack-v2-upgrade when a project pins Rspack 1.x and needs a structured v2 migration instead of ad-hoc config guessing.
- rspack-v2-upgrade
Rspack V2 Upgrade by the numbers
- 431 all-time installs (skills.sh)
- +13 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #1,019 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 rspack-v2-upgradeAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 431 |
|---|---|
| repo stars | ★ 86 |
| Last updated | August 4, 2026 |
| Repository | rstackjs/agent-skills ↗ |
How do you migrate a Rspack 1.x project to v2?
Use rspack-v2-upgrade for development tasks
Who is it for?
Frontend developers maintaining Rspack 1.x bundler configs who need a guided migration to Rspack v2 using the official breaking-change reference.
Skip if: Webpack-only projects, brand-new Rspack setups already on v2, or teams not using rspack.config-based build pipelines.
When should I use this skill?
User mentions upgrading Rspack to v2, Rspack 1.x migration, rspack.config breaking changes, or Rspack dependency bumps.
What you get
Updated package.json Rspack dependencies, migrated rspack.config file, and a list of applied breaking changes from the v2 guide.
- updated rspack dependencies
- migrated rspack.config
- breaking change checklist
By the numbers
- Supports 4 common rspack.config extensions: .ts, .js, .mjs, and .cjs
Files
Rspack 1.x to v2 Upgrade
Workflow
1. Confirm current setup
- Read
package.jsonto identify Rspack packages in use. - Locate the Rspack config file (commonly
rspack.config.(ts|js|mjs|cjs)).
2. Open the official migration guide
- Use the official guide as the single source of truth:
- https://rspack.rs/guide/migration/rspack_1.x
3. Plan required changes
- 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
- Upgrade Rspack packages to v2:
@rspack/core,@rspack/cli,@rspack/dev-server,@rspack/plugin-react-refresh.
5. Apply migration changes
- Update the Rspack config and related code according to the official guide.
- Remove deprecated or unsupported options.
6. Validate
- Run 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
Pick rspack-v2-upgrade for Rspack 1.x to v2 migrations; use general frontend upgrade skills when the bundler is Webpack or Vite instead of Rspack.
FAQ
What is the first step in rspack-v2-upgrade?
rspack-v2-upgrade reads package.json to identify installed Rspack packages and locates the rspack.config.(ts|js|mjs|cjs) file before consulting the official v2 migration guide.
Which guide does rspack-v2-upgrade use?
rspack-v2-upgrade treats https://rspack.rs/guide/migration/rspack_1.x as the single source of truth for Rspack 1.x to v2 breaking changes and plugin updates.
Which config filenames does rspack-v2-upgrade support?
rspack-v2-upgrade looks for rspack.config.ts, rspack.config.js, rspack.config.mjs, or rspack.config.cjs as the project configuration file to migrate.