独自ドメイン+Cloudflare Pages モノレポで複数ブラウザゲームを統合運用する構成
個人でブラウザゲームを複数作っていくと、最初はゲームごとに別々の GitHub リポジトリと GitHub Pages で公開するのが手軽です。 しかし作品数が増えて独自ドメインへ移行し、ポートフォリオやブログもまとめて発信したくなると、URL構造や共通ページの管理が課題になってきます。
1. なぜ /games/ 配下のモノレポ構成にしたのか
Unimate JP では、次のような階層構造でコンテンツを整理しています。
unimate-jp.com/
├── / (総合トップ)
├── /games/ (ゲームポータル・遊び方ガイド)
│ ├── mousoutero/
│ ├── zonbi/
│ └── flashanzan/
├── /portfolio/ (制作ポートフォリオ)
├── /blog/ (個人開発・技術ブログ)
└── /privacy/, /about/, /contact/
この構造にすることで、ゲーム同士の回遊がしやすくなるだけでなく、将来のブログ記事やポートフォリオ作品もすべて 1 つのドメイン資産として積み上げられるメリットがあります。
2. npm workspaces で各ゲームの独立性を保ちながら一括ビルド
リポジトリ内は site/(トップ・ポータル・ブログ等)と games/*(個別の Vite ゲームプロジェクト)に分割し、ルートの package.json で npm workspaces を有効化しています。
- 各ゲームの
vite.config.tsはbase: './'を維持しているため、サブディレクトリ配下でもアセット参照が壊れない - 開発時は
npm run dev:mousouteroのように単体ゲームだけ軽量に起動できる - デプロイ時はルートで
npm run buildを実行すると、site/とgames/*の全ビルド成果物が自動的にdist/とdist/games/<slug>/に統合される
3. Cloudflare Pages を選んだ理由
静的サイトの配信先には Cloudflare Pages を採用しました。GitHub リポジトリと連携しておけば main ブランチへプッシュするだけで自動ビルド&デプロイが走り、エッジCDNによる高速配信と自動HTTPSが無料枠で利用できます。
また、Xserver ドメイン側のネームサーバーを Cloudflare へ向けることで、www なしのルートドメイン(unimate-jp.com)もスムーズに割り当てられるのが大きな利点です。
4. 新しいゲームや記事を追加する手順のシンプルさ
新しいゲームを追加したいときは games/<新しいゲーム名>/ に Vite プロジェクトを置き、ポータルページに紹介カードを追加するだけで自動ビルド対象になります。
ブログ記事も site/blog/posts/<記事スラッグ>/index.html を追加すれば Vite のマルチページ検出によって自動でビルドされるため、制作そのものに集中できる環境が整いました。
(最終的には wrangler.jsonc を配置し、Cloudflare 公式推奨の Workers Static Assets 構成で運用しています。)