モノレポ概要

モノレポの構造とアプリの整理方法を理解する。

モノレポとは？

モノレポ（モノリシックリポジトリ）は、複数のプロジェクト、アプリケーション、共有コードを含む単一のリポジトリです。各アプリに個別のリポジトリを持つ代わりに、すべてが1か所にまとめられています。

Vibe Coderにとってのメリット

• 共有コード：共通のユーティリティ、型、設定がすべてのアプリで共有される
• 一貫したパターン：すべてのアプリが同じ構造と規則に従う
• 単一の情報源：1つのCLAUDE.mdファイルにすべてのガイドラインが含まれる
• 簡単なコラボレーション：Claudeがコードベース全体のコンテキストを理解できる

リポジトリ構造

vibe-coding-platform/
├── apps/                    # すべてのアプリケーションがここに
│   ├── checkin-board/       # アプリの例
│   ├── breakfast-tracker/   # 別のアプリ
│   └── your-new-app/        # あなたのアプリはここに
├── shared/                  # 共有リソース
│   ├── database/            # データベーススキーマ（Prisma）
│   ├── auth/                # 認証サービス
│   ├── storage/             # オブジェクトストレージヘルパー（Railwayバケット）
│   ├── api/                 # 共有APIコントラクト
│   └── types/               # 共有TypeScript型
├── templates/               # 新規プロジェクト用テンプレート
├── CLAUDE.md                # AI開発ガイドライン
└── package.json             # ルートワークスペース設定

プラットフォーム構成

このファウンデーション版では次を提供します。

• 認証の一元化（Auth UI + Auth API：マジックリンク、パスキー、端末パスワード）
• 会社ごとの 1 つの Postgres（Neon の DATABASE_URL）— 認証テーブルとアプリデータ
• 全アプリのランチャー App Portal
• GitHub Actions → Railway デプロイと Cloudflare DNS によるカスタムドメイン

apps/ 配下の各アプリは独立した Next.js サービスです。共有 middleware で認証し、pg で会社 DB にデータを保存します。

カスタムドメイン（staging / production）

各デプロイ後、CI が Railway カスタムドメインと Cloudflare DNS レコードを作成します。

• ドメイン形式: {service-name}.{RAILWAY_APP_DOMAIN_SUFFIX}
• GitHub Environment ごとに RAILWAY_APP_DOMAIN_SUFFIX を設定（例: apps.staging.acme.com / apps.acme.com）
• 同環境に CLOUDFLARE_API_TOKEN と CLOUDFLARE_ZONE_ID が必要

apps/ディレクトリ

apps/ディレクトリ内の各アプリは、以下を持つスタンドアロンのNext.jsアプリケーションです：

• package.json - 依存関係とスクリプト
• app/ディレクトリ - Next.js App Routerページ
• deploy.config.yml - Railwayデプロイ設定

アプリの命名規則

アプリはケバブケース（小文字とハイフン）を使用します：

shared/ディレクトリ

複数のアプリが使用できる共有リソース：

さらに詳しく: データベース、認証とアクセス制御、ファイルストレージ。

データベースアクセス

アプリはランタイムのデータベースクエリにpgライブラリ（Prismaクライアントではなく）を使用します。テンプレート付属のgetDb()ヘルパーを使い、SQLインジェクション対策として必ずパラメータ化クエリ（$1, $2, …）を使ってください：

import { getDb } from '@/app/_lib/db';

const db = getDb();
const result = await db.query(
  'SELECT * FROM my_app_users WHERE id = $1',
  [userId]
);
const users = result.rows;

注意: データベースクエリはデプロイ環境（PRプレビューまたは本番）でのみ実行されます。スキーマとマイグレーションの全体フローはデータベースを参照してください。

知っておくべき重要ファイル

CLAUDE.md（ルート）

AI開発で最も重要なファイル。以下を含みます：

• コーディング標準と規則
• Gitワークフロールール
• データベースガイドライン
• デプロイ手順

アプリ固有のファイル

各アプリには独自のドキュメントがある場合があります：

モノレポでの作業

コマンドの実行

常にリポジトリルートからコマンドを実行します。アプリをローカルで動かすことはありません — PRを開けばステージングと本番ですべて動きます（デプロイ参照）。ローカルで実行するのは、コミット前にCIと同じチェックを再現するビルドだけです:

# コミット前にビルドを確認（CIが走らせるのと同じチェック）
pnpm build:your-app-name

依存関係のインストール

アプリディレクトリ内でpnpm installを実行しないでください：

# ✅ 正しい：リポジトリルートから実行
pnpm install

# ❌ 間違い：アプリディレクトリ内で実行しない
cd apps/my-app && pnpm install

新しい依存関係の追加

# 特定のアプリに追加
pnpm --filter my-app-name add date-fns

# 開発依存関係として追加
pnpm --filter my-app-name add -D @types/some-package

クイズ

次のステップ

• GitワークフローについてブランチとPRを学ぶ
• 日々の開発のためにワークフローを確認する