Rspress v1 to v2 Upgrade

Workflow

1. 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)).
   • Check for custom theme files and MDX usage.

2. Open the official upgrade guide

   • Use the v1 → v2 guide as the source of truth:
     • https://rspress.rs/guide/migration/rspress-1-x

3. Plan the upgrade path

   • List breaking changes that apply to the project's current config, plugins, and theme.
   • Note any removed or renamed packages, options, and APIs.