1 
2ある程度複雑なソフトウェアプロジェクトを進める際、MonorepoとPolyrepoの選択はチームの生産性やコードのスケーラビリティに大きな影響を与えます。本記事では両者の違い、メリット・デメリットを分析し、あなたのプロジェクトに最適な選択肢を考えます。
3 
4## MonorepoとPolyrepoとは？
5 
6### Monorepo
7 
8**Monorepo**（モノリポジトリ）は、複数のプロジェクトやサービス、パッケージのソースコードを1つのリポジトリで管理する方法です。
9 
10```plaintext filename="Monorepo構成例"
11my-monorepo/
12  packages/
13    frontend/
14    backend/
15    shared/
16  package.json
17  turbo.json
18```
19 
20### Polyrepo
21 
22**Polyrepo**（ポリリポジトリ）は、各プロジェクトやサービス、パッケージごとに独立したリポジトリを持つ方法です。
23 
24```plaintext filename="Polyrepo構成例"
25repos/
26  frontend/
27    package.json
28  backend/
29    package.json
30  shared/
31    package.json
32```
33 
34## 視覚的な違い
35 
36```mermaid
37flowchart TD
38    subgraph Monorepo
39        A1["frontend/"]
40        A2["backend/"]
41        A3["shared/"]
42    end
43    style Monorepo fill:#e0e7ff,stroke:#6366f1,stroke-width:2px
44```
45 
46```mermaid
47flowchart TD
48    subgraph Polyrepo
49        B1["frontend repo"]
50        B2["backend repo"]
51        B3["shared repo"]
52    end
53    style Polyrepo fill:#fee2e2,stroke:#ef4444,stroke-width:2px
54```
55 
56## メリット・デメリット
57 
58### Monorepo
59 
60**メリット：**
61- コード共有が容易（例：共通ライブラリ）。
62- 複数プロジェクトにまたがる一括リファクタリングが可能。
63- 依存関係や設定の一元管理。
64 
65**デメリット：**
66- コード量が増えるとリポジトリが重くなりがち。
67- 部分的なビルドやテストのためのツール（例：Nx、Turborepo）が必要。
68 
69### Polyrepo
70 
71**メリット：**
72- 各チーム・プロジェクトが独立。
73- 小規模プロジェクトの管理が容易。
74- アクセス権限の細かな設定が可能。
75 
76**デメリット：**
77- パッケージ公開なしでのコード共有が難しい。
78- 複数リポジトリをまたぐリファクタリングが複雑。
79- 設定の重複が発生しやすい。
80 
81## 実例：Turborepoを使ったMonorepo
82 
83Turborepoを使ってフロントエンドとバックエンドを含むMonorepoを作成する場合を考えます。
84 
85### 1. Monorepoの初期化
86 
87```bash
88npx create-turbo@latest
89```
90 
91### 2. 典型的な構成
92 
93```plaintext
94my-monorepo/
95  apps/
96    web/        # フロントエンド Next.js
97    api/        # バックエンド Node.js/Express
98  packages/
99    ui/         # 共通コンポーネントライブラリ
100    utils/      # 共通関数
101  turbo.json
102  package.json
103```
104 
105### 3. `package.json`のワークスペース例
106 
107```json
108{
109  "private": true,
110  "workspaces": [
111    "apps/*",
112    "packages/*"
113  ]
114}
115```
116 
117### 4. 共通ライブラリのインポート例
118 
119`packages/utils/src/formatDate.ts`に関数があるとします：
120 
121```ts
122// packages/utils/src/formatDate.ts
123export function formatDate(date: Date): string {
124  return date.toLocaleDateString('ja-JP');
125}
126```
127 
128フロントエンドで：
129 
130```ts
131// apps/web/pages/index.tsx
132import { formatDate } from '@myorg/utils';
133 
134export default function Home() {
135  return <div>今日は {formatDate(new Date())}</div>;
136}
137```
138 
139## Monorepoを選ぶべき場合
140 
141- 複数の関連プロジェクトに取り組む中〜大規模チーム。
142- コード共有や大規模リファクタリングが必要な場合。
143- 急成長し、ビルドやテストの最適化が求められるプロジェクト。
144 
145## Polyrepoを選ぶべき場合
146 
147- 小規模または独立したプロジェクト。
148- 別々の製品に取り組む独立チーム。
149- 厳格なアクセス制御が必要な場合。
150 
151## 結論
152 
153すべての人に完璧な解決策はありません。選択はチーム規模、プロジェクトの複雑さ、コラボレーションの必要性によって異なります。重要なのはトレードオフを理解し、複雑さを管理するために適切なツールを選ぶことです。