ゲーム デプロイメント

ブラウザゲームを公開アクセス用にデプロイします。here.now がデフォルト — ゼロ設定で瞬時に静的ホスティングできます。GitHub Pages は、Git ベースのデプロイが必要な場合の代替手段として利用できます。

here.now デプロイメント (デフォルト)

前提条件

• here-now スキルがインストールされていること (npx skills add heredotnow/skill --skill here-now -g)
• オプション: 永続ホスティング用の $HERENOW_API_KEY または ~/.herenow/credentials

クイックデプロイ

npm run build
~/.agents/skills/here-now/scripts/publish.sh dist/

スクリプトは https://<slug>.here.now/ のようなライブ URL を出力します。

here.now がデフォルトである理由

• ゼロ設定 — base パス、Git リポジトリ、GitHub CLI 不要
• 瞬時 — サイトが即座にライブになります (伝播待ちなし)
• base パスの問題なし — サブドメインのルートからコンテンツを配信 (base: '/' またはデフォルト)
• どこでも動作 — curl、file、jq のみ必要

Vite の base パス

here.now はサブドメインのルートから配信するため、デフォルトの base パスを使用してください:

export default defineConfig({
  base: '/',
  // ... 残りの設定
});

重要: 24 時間以内にサイトをクレームしてください

API キーなしでは、パブリッシュは 匿名であり 24 時間で有効期限切れになります。パブリッシュスクリプトは クレーム URL を返します — ユーザーはこの URL にアクセスして無料の here.now アカウントを作成し、サイトを永続的に保持する必要があります。クレームトークンは 1 回だけ表示され、回復できません。 クレームしない場合、サイトは消滅します。

匿名パブリッシュのたびに、ユーザーに 24 時間のウィンドウとクレーム URL について必ず伝える必要があります。 これはオプションではありません。

機能	匿名	認証済み
有効期限	24 時間 (その後削除!)	永続
最大ファイルサイズ	250 MB	5 GB
レート制限	5/時間/IP	60/時間/アカウント

永続ホスティング用に API キーを設定するには (24 時間のウィンドウをスキップ):

まず、キーが既に存在するかを確認します: test -f .env && grep -q '^HERENOW_API_KEY=.' .env && echo "found" 見つかった場合は、set -a; . .env; set +a でエクスポートし、プロンプトをスキップします。

見つからない場合:

1. ユーザーにメールアドレスを聞く
2. マジックリンクを送信: curl -sS https://here.now/api/auth/login -H "content-type: application/json" -d '{"email": "user@example.com"}'
3. ユーザーがリンクをクリックし、ダッシュボードから API キーをコピー
4. ユーザーがキーを貼り付け: HERENOW_API_KEY=their-key-here (.env に保存され自動的にマスク)
5. また認証情報ファイルに保存: mkdir -p ~/.herenow && grep '^HERENOW_API_KEY=' .env | cut -d= -f2- > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials

デプロイの更新

npm run build
~/.agents/skills/here-now/scripts/publish.sh dist/ --slug <slug>

slug は各パブリッシュ後に .herenow/state.json に保存され、スクリプトが更新時に自動的にロードします。

デプロイスクリプト

package.json に追加:

{
  "scripts": {
    "deploy": "npm run build && ~/.agents/skills/here-now/scripts/publish.sh dist/"
  }
}

既存の slug への更新:

{
  "scripts": {
    "deploy": "npm run build && ~/.agents/skills/here-now/scripts/publish.sh dist/ --slug <slug>"
  }
}

GitHub Pages デプロイメント (代替手段)

Git ベースのデプロイが必要な場合、または GitHub リポジトリが既に設定されている場合は GitHub Pages を使用してください。

前提条件

• GitHub CLI がインストールされていること (gh)
• Git リポジトリが初期化され GitHub にプッシュされていること

クイックデプロイ

npm run build && npx gh-pages -d dist

完全なセットアップ

1. ゲームをビルド:

npm run build

2. サブディレクトリにデプロイする場合は vite.config.js に正しい base パスを確認:

export default defineConfig({
  base: '/<repo-name>/',
  // ... 残りの設定
});

3. GitHub CLI でデプロイ:

gh repo create <game-name> --public --source=. --push
npm install -D gh-pages
npx gh-pages -d dist

4. リポジトリ設定で GitHub Pages を有効化 (gh-pages ブランチを自動検出すべき).

ゲームは https://<username>.github.io/<repo-name>/ でライブになります。

自動デプロイ

package.json に追加:

{
  "scripts": {
    "deploy": "npm run build && npx gh-pages -d dist"
  }
}

Play.fun 登録

デプロイ後、ゲームを Play.fun に登録して収益化します。統合の詳細については /game-creator:playdotfun スキルを使用してください。

デプロイされた URL は登録時に gameUrl になります:

await client.games.register({
  name: 'Your Game Name',
  gameUrl: 'https://<slug>.here.now/',  // または GitHub Pages URL
  maxScorePerSession: 500,
  maxSessionsPerDay: 20,
  maxCumulativePointsPerDay: 5000
});

その他のホスティングオプション

• Vercel: npx vercel --prod (Vite を自動検出)
• Netlify: リポジトリを接続し、ビルドコマンドを npm run build、公開ディレクトリを dist に設定
• Railway: Railway スキルを使用してデプロイ
• itch.io: dist/ フォルダを HTML5 ゲームとしてアップロード

使用例

デフォルト (here.now)

/game-deploy

結果: dist/ をビルド → here.now でパブリッシュ → 数秒でゲームが https://<slug>.here.now/ でライブに。今後のワンコマンドデプロイ用に npm run deploy スクリプトを追加。

GitHub Pages

/game-deploy github-pages

結果: 正しい base パスでビルド → gh-pages ブランチにプッシュ → 1-2 分でゲームが https://<user>.github.io/<game>/ でライブに。

トラブルシューティング

here.now 429 レート制限

原因: 短期間に多くのデプロイが行われています。here.now は匿名デプロイにレート制限があります。 対策: 数分待ってリトライしてください。頻繁なデプロイの場合は、GitHub Pages または Vercel の使用を検討してください。

匿名 here.now サイトが有効期限切れに

原因: 匿名 here.now デプロイは一時的であり、一定期間の非活動後に有効期限切れになります。 対策: npx here.now で再デプロイしてください。永続ホスティングの場合は、GitHub Pages (gh-pages ブランチ) または Vercel を使用してください。有効期限切れになりません。

GitHub Pages デプロイ後の 404 エラー

原因: Vite の base パスが GitHub Pages の URL 構造 (/<repo-name>/) と一致しません。 対策: vite.config.js で base: '/<repo-name>/' を設定してください。リポジトリの Pages 設定で gh-pages ブランチが選択されていることを確認します。GitHub の CDN が伝播するまで 1-2 分待ってください。

デプロイ後に空白ページが表示される (アセットパス)

原因: アセットパスが絶対 URL (/assets/...) を使用しており、デプロイホストで正しく解決されません。 対策: 相対パス (./assets/...) を使用するか、デプロイ URL に一致するように Vite の base オプションを設定してください。ローカルで npm run build を実行し、デプロイ前にローカルサーバーで dist/ フォルダをテストします。

gh-pages プッシュが拒否された

原因: リモート gh-pages ブランチが分岐している、またはブランチ保護ルールで強制プッシュがブロックされています。 対策: リポジトリを所有していてブランチ保護がない場合は git push origin gh-pages --force を使用してください。保護されている場合は、リモート gh-pages ブランチを先に削除: git push origin --delete gh-pages、その後再デプロイしてください。

デプロイ前チェックリスト

• npm run build がエラーなく成功している
• npm run preview で本番ビルドをテストしている
• デバッグ用の console.log ステートメントを削除している
• すべてのアセットがビルドに含まれていることを確認している
• 必要に応じてモバイル/レスポンシブな動作を確認している
• index.html に適切な <title> とメタタグを設定している