1 
2Вибір між monorepo та polyrepo може суттєво вплинути на продуктивність команди та масштабованість коду.
3 
4## Що таке Monorepo та Polyrepo?
5 
6### Monorepo
7 
8**Monorepo**  -  це єдиний репозиторій, що містить вихідний код кількох проєктів.
9 
10```plaintext filename="Example Monorepo Structure"
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="Example Polyrepo Structure"
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- Cross-repo рефакторинг складніший.
79- Можливе дублювання конфігурацій.
80 
81## Практичний Приклад: Monorepo з Turborepo
82 
83```bash
84npx create-turbo@latest
85```
86 
87```plaintext
88my-monorepo/
89  apps/
90    web/        # frontend Next.js
91    api/        # backend Node.js/Express
92  packages/
93    ui/         # shared component library
94    utils/      # shared functions
95  turbo.json
96  package.json
97```
98 
99```json
100{
101  "private": true,
102  "workspaces": [
103    "apps/*",
104    "packages/*"
105  ]
106}
107```
108 
109```ts
110// packages/utils/src/formatDate.ts
111export function formatDate(date: Date): string {
112  return date.toLocaleDateString('en-US');
113}
114```
115 
116```ts
117// apps/web/pages/index.tsx
118import { formatDate } from '@myorg/utils';
119 
120export default function Home() {
121  return <div>Today is {formatDate(new Date())}</div>;
122}
123```
124 
125## Коли Обрати Monorepo?
126 
127- Середні та великі команди, що працюють над пов'язаними проєктами.
128- Потреба в спільному використанні коду та масштабному рефакторингу.
129 
130## Коли Обрати Polyrepo?
131 
132- Малі або незалежні проєкти.
133- Окремі команди, що працюють над різними продуктами.
134- Дуже обмежувальні політики доступу.
135 
136## Висновок
137 
138Ідеального рішення для всіх не існує. Вибір залежить від розміру команди, складності проєкту та потреб у співпраці.
139