Migrate to Rsbuild
Goal
Migrate webpack, Vite, create-react-app (CRA/CRACO), or Vue CLI projects to Rsbuild with minimal behavior changes and clear verification.
Supported source frameworks
- webpack
- Vite
- CRA / CRACO
- Vue CLI
Migration principles (must follow)
- Official guide first: treat Rsbuild migration docs as source of truth.
- Smallest-change-first: complete baseline migration first, then migrate custom behavior.
- Do not change business logic: avoid touching app runtime code unless user explicitly asks.
- Validate before cleanup: keep old tool dependencies/config temporarily if needed; remove only after Rsbuild is green.
Workflow
- Detect source framework
- Check package.json dependencies/scripts and config files: - webpack: webpack.config.* - Vite: vite.config.* - CRA/CRACO: react-scripts, @craco/craco, craco.config.* - Vue CLI: @vue/cli-service, vue.config.*
- Apply framework-specific deltas
- webpack: references/webpack.md - Vite: references/vite.md - CRA/CRACO: references/cra.md - Vue CLI: references/vue-cli.md
- Validate behavior
- Run dev server to verify the project starts without errors. - Run build command to verify the project builds successfully. - If issues remain, compare the old project configuration with the migration guide and complete any missing mappings.
- Cleanup and summarize
- Remove obsolete dependencies/config only after validation passes. - Summarize changed files and any remaining manual follow-ups.