デプロイ

ビルド

サイトはビルド時に Next.js によって静的 HTML として生成されます:

pnpm build

Next.js はホームページ、ドキュメントページ、サイトマップ、静的アセットを 7言語すべて分プリレンダリングします。サーバーランタイムがないため、 任意の静的ホストで動きます。

ホスティング

本番ホスティングは Vercel:

• framework preset: Next.js
• root directory: apps/web
• build command: pnpm build

ドメインは ella.yuricunha.com で、apps/web/src/data/site.ts とアプリの メタデータで設定され、正準 URL、Open Graph、サイトマップを駆動します。

ドキュメントルート

• /docs 利用可能なドキュメントページのインデックス（言語ごと）;
• /docs/<slug> 個別のドキュメントページ（言語ごと）。

どちらもビルド時に生成される静的ルートです。デフォルト言語（英語）には URL プレフィックスがありません。他の言語はプレフィックスを付けます。 例: /pt/docs や /ja/docs。

ローカライゼーションルート

• デフォルト英語: https://ella.yuricunha.com
• 他の言語: https://ella.yuricunha.com/<locale>

各ページは7言語すべての hreflang オルタネートを宣言し、サイトマップは 各バリアントをリストします。

アナリティクス

Umami は準備されていますが、デフォルトでは無効です。Analytics コンポーネントは、ビルド時に両方の環境変数が存在する場合のみ レンダリングされます:

NEXT_PUBLIC_UMAMI_SRC=https://your-umami-host/script.js
NEXT_PUBLIC_UMAMI_WEBSITE_ID=your-website-id

なければ、サイトはアナリティクス JavaScript をゼロ配信します。プレース ホルダー ID はコミットされません。

CI パイプライン

GitLab パイプラインは main で実行されます。これは本人確認を持つ GitLab プロファイルで作成されます。GitLab.com は本人確認なしでは CI ジョブを実行しないためです。起動:

glab api --method POST \
  "projects/isyuricunha%2Fella-mizuki/pipeline" -f "ref=main"

作成されたパイプラインが success に到達することを確認します: quality、build、SAST、secret detection がすべて通ってから、デプロイを グリーンと見なします。

SEO

• ロケールレイアウトでの metadata、Open Graph、Twitter カード、 canonical、JSON-LD;
• robots.txt とサイトマップはビルドに生成されます;
• ソーシャルカードは public/og.png（1200x630、レンダリングされた HTML テンプレートから Geist フォントで生成）;
• 各言語に独自のメタデータと hreflang オルタネートが与えられます。