Rspack V2 Upgrade

This walks you through bumping a Rspack 1.x project to v2 by checking your package.json and config, pulling up the official migration guide at rspack.rs, then systematically updating dependencies like @rspack/core and applying breaking changes to your configuration. It's methodical: plan the changes, upgrade the packages, fix the config, then validate with your build and tests. Useful if you want to avoid the usual upgrade mess of missing a renamed option or deprecated plugin API. The workflow is pretty paint by numbers, which is exactly what you want when dealing with breaking changes in a bundler.

skills.sh installs: 528
GitHub stars: 98
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add rstackjs/agent-skills --skill rspack-v2-upgrade --agent claude-code

Installs into .claude/skills of the current project.

Files

Rspack 1.x to v2 upgrade

Workflow

Confirm current setup
- Read package.json to identify Rspack packages in use.
- Locate the Rspack config file (commonly rspack.config.(ts|js|mjs|cjs)).
Open the official migration guide
- Use the official guide as the single source of truth:
  - https://rspack.rs/guide/migration/rspack_1.x
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.
Update dependencies
- Upgrade Rspack packages to v2: @rspack/core, @rspack/cli, @rspack/dev-server, @rspack/plugin-react-refresh.
Apply migration changes
- Update the Rspack config and related code according to the official guide.
- Remove deprecated or unsupported options.
Validate
- Run build and dev commands.
- Run project tests or type checks.
- Fix any warnings or errors surfaced by the new version.