migrate-to-rsbuild

Rsbuild への移行

目標

webpack、Vite、create-react-app（CRA／CRACO）、または Vue CLI のプロジェクトを、動作の変更を最小限に抑え、明確な検証を行いながら Rsbuild に移行します。

対応する移行元のフレームワーク

• webpack
• Vite
• CRA／CRACO
• Vue CLI

移行の原則（必ず従ってください）

1. 公式ガイドを最優先：Rsbuild の移行ドキュメントを信頼できる情報源として扱います。
2. 変更は最小限から：まず基本の移行を完了し、その後にカスタム動作を移行します。
3. ビジネスロジックは変更しない：ユーザーから明示的な依頼がない限り、アプリの実行時コードには手を加えないでください。
4. クリーンアップの前に検証：必要に応じて古いツールの依存関係や設定を一時的に残し、Rsbuild が正常に動作してから削除します。

ワークフロー

1. 移行元のフレームワークを検出する

   • package.json の依存関係やスクリプト、設定ファイルを確認します。
     • webpack：webpack.config.*
     • Vite：vite.config.*
     • CRA／CRACO：react-scripts、@craco/craco、craco.config.*
     • Vue CLI：@vue/cli-service、vue.config.*

2. フレームワーク固有の差分を適用する

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

3. 動作を検証する

   • 開発サーバーを起動し、プロジェクトがエラーなく起動することを確認します。
   • ビルドコマンドを実行し、プロジェクトが正常にビルドされることを確認します。
   • 問題が残る場合は、移行元のプロジェクト設定と移行ガイドを比較し、不足しているマッピングをすべて補います。

4. クリーンアップして要約する

   • 検証に合格した後でのみ、不要になった依存関係や設定を削除します。
   • 変更したファイルと、残っている手動対応事項を要約します。