開発

前提条件

• Node.js 24 以降
• pnpm 12（package.json の packageManager で固定）

セットアップ

pnpm install

コマンド

pnpm dev          # turbo dev: HMR 付き Web アプリ
pnpm type-check   # turbo type-check: モノレポ全体
pnpm lint         # eslint（next + typescript ルール）、警告ゼロ
pnpm test         # turbo test（vitest）
pnpm format:check # prettier: リポジトリ全体
pnpm build        # 本番ビルド → apps/web/.next

プッシュ前にすべてのチェックが通ること: pnpm lint エラーゼロ、 pnpm type-check エラーゼロ、pnpm format:check 差分なし、pnpm build 成功。

ローカライゼーションのワークフロー

• UI 文字列: packages/i18n/messages/en.json を編集し、他の6つの言語 ファイルを翻訳します。キー構造は同一に保ちます。
• Docs: packages/content/docs/en/<slug>.md を編集し、翻訳を更新します。 翻訳がない言語は自動的に英語にフォールバックします。
• messages や docs を変更したら pnpm build を実行し、全言語のルートを ブラウザで確認します。

Git のアイデンティティ

リポジトリのコミットはプロジェクト所有者のアイデンティティで作成され、 各コミットには共同著者のトレーラーが付きます:

Co-authored-by: Ella Mizuki

ブランチ保護

main は保護されています: Maintainer による push、force push 無効。 履歴の書き換え（コミットの著者変更など）には、保護を一時的に外し、 force push を行い、まったく同じ設定で保護を復元する必要があります。

継続的インテグレーション

このリポジトリを監視する CI サーバーはありません。プッシュごとに品質ゲートを 実行してください（pnpm type-check、pnpm lint、pnpm test、 pnpm format:check、pnpm build）。Vercel がデプロイ時に本番バンドルを ビルドし、ビルドが失敗すればデプロイも失敗します。

マージ前のテスト

検証:

• lint、typecheck、format:check、build;
• 375、768、1024、1440、1920px でのブラウザパス、水平オーバーフローゼロ、 全言語で;
• reduced-motion パス: シャイマーやトランジションがアクティブでない、 コンテンツが見える;
• アンカーナビゲーションが固定ヘッダーを避ける（スクロールパディング）;
• 全言語でドキュメントルートが解決する（英語フォールバック含む）。