rspack-v2-upgrade
Rspack 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:
More from rstackjs/agent-skills
rsbuild-best-practices
Rsbuild best practices for config, CLI workflow, type checking, bundle optimization, assets, and debugging. Use when writing, reviewing, or troubleshooting Rsbuild projects.
562rslib-best-practices
Rslib best practices for config, CLI workflow, output, declaration files, dependency handling, build optimization and toolchain integration. Use when writing, reviewing, or troubleshooting Rslib projects.
406rstest-best-practices
Rstest best practices for config, CLI workflow, test writing, mocking, snapshot testing, DOM testing, coverage, multi-project setup, CI integration, performance and debugging. Use when writing, reviewing, or troubleshooting Rstest test projects.
229rspack-best-practices
Rspack best practices for config, CLI workflow, type checking, CSS, bundle optimization, assets and profiling. Use when writing, reviewing, or troubleshooting Rspack projects.
223rsbuild-v2-upgrade
Use when upgrading a Rsbuild 1.x project to v2, including dependency and configuration updates.
207rsdoctor-analysis
Use when analyzing Rspack/Webpack bundles from local `rsdoctor-data.json` and producing evidence-based optimization recommendations.
164