packages:
  - 'apps/*'
  - 'packages/*'

# ファントム依存の防止（推奨）
shamefully-hoist=false
strict-peer-dependencies=true

# モノレポ用設定
link-workspace-packages=true
prefer-workspace-packages=true

{
  "private": true,
  "scripts": {
    "dev": "turbo dev",
    "build": "turbo build",
    "test": "turbo test",
    "lint": "turbo lint",
    "type-check": "turbo type-check"
  },
  "devDependencies": {
    "turbo": "latest"
  }
}

project-root/
├── apps/                 # アプリケーション
│   ├── web/              # フロントエンドアプリ
│   ├── api/              # バックエンド API
│   └── admin/            # 管理画面
├── packages/             # 共有パッケージ
│   ├── ui/               # 共有 UI コンポーネント
│   ├── config/           # 共有設定（ESLint, TypeScript等）
│   ├── schemas/          # 共有 Zod スキーマ
│   └── utils/            # 共有ユーティリティ
├── pnpm-workspace.yaml
├── turbo.json
└── package.json

apps/:
  - 独立してデプロイ可能なアプリケーション
  - エントリーポイント（サーバー起動、ルーティング）
  - apps 同士は直接依存しない

packages/:
  - 再利用可能な共有コード
  - 明確なインターフェース（exports）
  - packages 間の依存は許可（循環依存は禁止）

{
  "name": "@myapp/web",
  "dependencies": {
    "@myapp/ui": "workspace:*",
    "@myapp/schemas": "workspace:*"
  }
}

apps → packages: OK（アプリが共有パッケージを使用）
packages → packages: OK（ただし循環禁止）
apps → apps: NG（アプリ間の直接依存は禁止）
packages → apps: NG（共有パッケージがアプリに依存しない）

# 特定パッケージに依存追加
pnpm add zod --filter @myapp/schemas

# ワークスペース内パッケージを依存追加
pnpm add @myapp/schemas --filter @myapp/web --workspace

# ルートに devDependency 追加
pnpm add -D turbo -w

{
  "name": "@myapp/schemas",
  "version": "0.0.0",
  "private": true,
  "main": "./src/index.ts",
  "types": "./src/index.ts",
  "exports": {
    ".": "./src/index.ts",
    "./user": "./src/user.ts"
  }
}

1. 明確な公開インターフェース（exports で定義）
2. 内部実装の隠蔽（公開しないモジュールは exports に含めない）
3. 最小限の依存（不要な依存を持ち込まない）
4. 型定義の同梱（types フィールド設定）
5. 循環依存の禁止

packages/config/
  └── tsconfig/
      ├── base.json        # 共通設定
      ├── nextjs.json      # Next.js 用
      ├── node.json        # Node.js / Workers 用
      └── react.json       # React ライブラリ用

// packages/config/tsconfig/base.json
{
  "compilerOptions": {
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "resolveJsonModule": true,
    "isolatedModules": true,
    "declaration": true,
    "declarationMap": true
  }
}

// apps/web/tsconfig.json
{
  "extends": "@myapp/config/tsconfig/nextjs.json",
  "include": ["src"],
  "exclude": ["node_modules"]
}

{
  "compilerOptions": {
    "paths": {
      "@/*": ["./src/*"]
    }
  }
}

// turbo.json
{
  "$schema": "https://turbo.build/schema.json",
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**", ".next/**"]
    },
    "dev": {
      "cache": false,
      "persistent": true
    },
    "test": {
      "dependsOn": ["^build"]
    },
    "lint": {},
    "type-check": {
      "dependsOn": ["^build"]
    }
  }
}

# 全パッケージで実行
pnpm turbo build
pnpm turbo test

# 特定パッケージのみ
pnpm turbo build --filter=@myapp/web
pnpm turbo dev --filter=@myapp/web

# 変更のあるパッケージのみ
pnpm turbo build --filter=...[HEAD~1]

# pnpm で直接
pnpm --filter @myapp/web dev
pnpm --filter @myapp/api add zod

原則:
  1. 変更のあるパッケージのみビルド・テスト
  2. キャッシュを最大限活用
  3. 依存関係の順序を考慮

Turborepo の Remote Cache:
  - CI で Turborepo のキャッシュを共有
  - ビルド時間の大幅な短縮

変更検出:
  - turbo --filter=...[base-branch] で affected のみ実行
  - GitHub Actions の paths フィルタと組み合わせ