Migrate Rspress projects from v1 to v2. Use when a user asks to upgrade Rspress, follow the v1-to-v2 guide, update configs/themes, or validate the upgrade.
설치
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
Migrate Rspress projects from v1 to v2. Use when a user asks to upgrade Rspress, follow the v1-to-v2 guide, update configs/themes, or validate the upgrade.
Rspress v1 to v2 Upgrade
Workflow
Confirm current setup
Read package.json to identify Rspress and plugin packages in use.
Locate the Rspress config file (commonly rspress.config.(ts|js|mjs|cjs)).
List breaking changes that apply to the project's current config, plugins, and theme.
Note any removed or renamed packages, options, and APIs.
Update dependencies
Replace rspress with @rspress/core@^2.0.0.
Remove packages now built into @rspress/core (e.g. rspress, @rspress/plugin-shiki, @rspress/plugin-auto-nav-sidebar, @rspress/plugin-container-syntax, @rspress/plugin-last-updated, @rspress/plugin-medium-zoom, @rspress/theme-default, @rspress/runtime).
Bump remaining Rspress plugins to latest versions via npx taze major --include /rspress/ -w -r.
If the project has a custom theme (in theme directory), use @rspress/core/theme-original to import the original theme components.
Update the Rspress config to match v2 options and defaults.
Remove deprecated or unsupported settings.
Validate
Run the build and dev server.
Fix any warnings or errors that appear in the new version. If errors or warnings occur, please refer to the Official Upgrade Guide and first check if it's caused by any omitted or incomplete migration steps.