トラブルシューティング

ビルド失敗: vitepress が見つからない

依存関係がインストールされ、Cloudflare Pages がビルド前にインストール手順を実行することを確認します。

npm install
npm run build

ビルド成功後にページが 404 になる

ビルド出力先が .vitepress/dist であることを確認します。出力先が違うと別のファイルがデプロイされます。

.vitepress/dist

docs.hideapps.top が開けない

1. docs.hideapps.top が Pages Custom domains に追加されていることを確認します。
2. docs CNAME レコードが存在することを確認します。
3. ターゲットが Pages プロジェクトドメインであることを確認します。
4. 追加直後なら Cloudflare の証明書発行を待ちます。

HTTPS 証明書が保留のまま

hideapps.top に証明書発行を制限する CAA レコードがないか確認します。ある場合は Cloudflare が使う認証局を許可します。

ローカルでは正常だがオンラインでスタイルが消える

このプロジェクトはサブドメインのルートにデプロイされるため、VitePress の base は不要です。/docs/ などのサブパスに置く場合のみ base を設定します。