モノレポ管理

目次

• 概要
• 使用場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

ビルド効率、依存関係管理、デプロイメント調整を維持しながら、複数の相互依存パッケージをサポートするスケーラブルなモノレポ構造を確立します。

使用場面

• マルチパッケージプロジェクト
• サービス間での共有ライブラリ
• マイクロサービスアーキテクチャ
• プラグインベースのシステム
• マルチアプリプラットフォーム (web + mobile)
• ワークスペース依存関係管理
• スケーラブルなチーム開発

クイックスタート

最小限の動作例:

{
  "name": "monorepo-root",
  "version": "1.0.0",
  "private": true,
  "workspaces": ["packages/*", "apps/*"],
  "devDependencies": {
    "lerna": "^7.0.0",
    "turbo": "^1.10.0"
  },
  "scripts": {
    "lint": "npm run lint -r",
    "test": "npm run test -r",
    "build": "npm run build -r",
    "clean": "npm run clean -r"
  }
}

リファレンスガイド

references/ ディレクトリの詳細な実装:

ガイド	内容
Npm Workspaces Configuration	Npm Workspaces Configuration、Lerna Configuration、Turborepo Configuration、Nx Workspace Configuration
Monorepo Directory Structure	モノレポディレクトリ構造
Workspace Dependencies	ワークスペース依存関係
Lerna Commands	Lerna コマンド
Turborepo Commands	Turborepo コマンド
CI/CD for Monorepo	モノレポ向け CI/CD
Version Management Across Packages	パッケージ間のバージョン管理

ベストプラクティス

✅ すること

• 依存関係にワークスペースプロトコルを使用する
• 一貫性のため共有 tsconfig を実装する
• CI/CD でビルド出力をキャッシュする
• CI でパッケージをフィルタリングして不要なビルドを回避する
• 共通依存関係をホイストする
• ワークスペース構造をドキュメント化する
• 一貫したバージョニング戦略を使用する
• ワークスペース全体にプリコミットフックを実装する
• クロスパッケージ依存関係をテストする
• 必要に応じてパッケージを独立してバージョニングする

❌ しないこと

• 循環依存を作成する
• ワークスペースパッケージにハードコードされたバージョンを使用する
• 1 つのパッケージだけ変更された場合にすべてのパッケージをビルドする
• ロックファイルの更新を忘れる
• ワークスペース境界を無視する
• 密結合されたパッケージを作成する
• 依存関係管理をスキップする
• パッケージごとに異なるツールを使用する