ショーケースをAstroから移行する

2026年3月27日 · 更新 2026年4月2日

コンテンツツリーをサイトの安定した中心に保つと、フレームワーク移行をレビューしやすくなります。

コンテンツを見慣れた形に保つ

ショーケースのAstroからの移行がうまくいったのは、コンテンツツリーを見慣れたまま保てたからです。ページはfrontmatterを持つ .mdx ファイルのまま、ディレクトリはナビゲーションを定義し続け、バイリンガルのミラーも同じファイル名を維持しました。読者から見ると、すでに理解しているサイトの下でエンジンが変わっただけです。

この継続性によって、変更を小さな単位でレビューできました。ルートの所有、パッケージのビルド、chrome bindingを個別に移行しながら、インストールガイドや執筆ワークフローの形を保てました。

ファイルではなく契約を移行する

フレームワークの切り替えは、ページの周辺にある動作の所有者が明確なままなら完了です。パッケージが共有chromeを描画し、ホストがサイトの個性を提供し、執筆者が同じ規約を使い続けます。古いディレクトリを新しいビルドシステムへコピーするのではなく契約として扱う方が、不足している部分を早く見つけられます。