mcpField
M
migrate-to-rsbuild

migrate-to-rsbuild

github.com/rstackjsDevelopment97329 installsUpdated 1w ago
Repository

About migrate-to-rsbuild

A migration skill for moving webpack, Vite, CRA/CRACO, or Vue CLI projects to Rsbuild. It guides developers through minimal configuration changes, behavior checks, and cleanup after validation.

Key features

  1. 01Detects the source framework from project files
  2. 02Applies framework-specific migration guidance
  3. 03Checks startup and build behavior
  4. 04Delays cleanup until validation succeeds

Use cases

  1. 01Migrating a webpack project to Rsbuild
  2. 02Moving a Vite or CRA/CRACO project to Rsbuild
  3. 03Replacing Vue CLI while preserving existing behavior

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/rstackjs/agent-skills --skill migrate-to-rsbuild

After installing, type/migrate-to-rsbuildin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
cra.md
vite.md
vue-cli.md
webpack.md

Details

From the project README

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)

  1. Official guide first: treat Rsbuild migration docs as source of truth.
  2. Smallest-change-first: complete baseline migration first, then migrate custom behavior.
  3. Do not change business logic: avoid touching app runtime code unless user explicitly asks.
  4. Validate before cleanup: keep old tool dependencies/config temporarily if needed; remove only after Rsbuild is green.

Workflow

  1. 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.*

  2. Apply framework-specific deltas

    • webpack: references/webpack.md
    • Vite: references/vite.md
    • CRA/CRACO: references/cra.md
    • Vue CLI: references/vue-cli.md

  3. 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.

  4. Cleanup and summarize

    • Remove obsolete dependencies/config only after validation passes.
    • Summarize changed files and any remaining manual follow-ups.

Comments

Markdown supported