About rspack-v2-upgrade
A migration workflow for upgrading projects from Rspack 1.x to v2. It guides developers through inspecting dependencies and configuration, applying the official migration guide, and validating the updated project.
Key features
- 01Inspect Rspack packages and config
- 02Consult the official migration guide
- 03Identify applicable breaking changes
- 04Upgrade packages and update config
- 05Validate builds, tests, and type checks
Use cases
- 01Planning a Rspack v2 migration
- 02Updating project configuration and plugins
- 03Checking an upgrade for build or test issues
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ rstackjs/ agent-skills --skill rspack-v2-upgradeAfter installing, type/rspack-v2-upgradein Claude Code to confirm it loaded.
Details
From the project READMERspack 1.x to v2 upgrade
Workflow
-
Confirm current setup
- Read
package.jsonto identify Rspack packages in use. - Locate the Rspack config file (commonly
rspack.config.(ts|js|mjs|cjs)).
- Read
-
Open the official migration guide
- Use the official guide as the single source of truth:
-
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.
- Upgrade Rspack packages to v2:
-
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.
Comments
Markdown supported