1 
2Karmaşık yazılım projeleri üzerinde çalışırken, monorepo ve polyrepo arasındaki tercih ekibinizin verimliliğini ve kodun ölçeklenebilirliğini önemli ölçüde etkileyebilir. Bu makalede, her yaklaşımın farklarını, avantaj ve dezavantajlarını analiz ediyor ve hangisinin sizin için doğru olduğunu anlamanıza yardımcı oluyoruz.
3 
4## Monorepo ve Polyrepo Nedir?
5 
6### Monorepo
7 
8Bir **monorepo** (monolitik depo), genellikle birbiriyle ilişkili birden fazla proje, hizmet veya paketin kaynak kodunu içeren tek bir depodur.
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 
22Bir **polyrepo** (çoklu depolar), her proje, hizmet veya paketin kendi ayrı deposuna sahip olması anlamına gelir.
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## Görsel Fark
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## Avantajlar ve Dezavantajlar
57 
58### Monorepo
59 
60**Avantajlar:**
61- Kod paylaşımını kolaylaştırır (örn. paylaşılan kütüphaneler).
62- Birden fazla proje üzerinde atomik refactoring.
63- Bağımlılıkların ve yapılandırmaların merkezi yönetimi.
64 
65**Dezavantajlar:**
66- Kod tabanı büyüdükçe ağırlaşabilir.
67- Kısmi build/test yönetimi için araçlar gerektirir (örn. Nx, Turborepo).
68 
69### Polyrepo
70 
71**Avantajlar:**
72- Her ekip/proje bağımsızdır.
73- Küçük projeler için yönetimi daha kolaydır.
74- Granüler erişim politikalarına izin verir.
75 
76**Dezavantajlar:**
77- Paket yayınlamadan kod paylaşmak daha zordur.
78- Depolar arası refactoring daha karmaşıktır.
79- Yapılandırmaların olası tekrarlanması.
80 
81## Pratik Örnek: Turborepo ile Monorepo
82 
83Turborepo kullanarak frontend ve backend içeren bir monorepo oluşturmak istediğinizi varsayalım.
84 
85### 1. Monorepo'yu başlatın
86 
87```bash
88npx create-turbo@latest
89```
90 
91### 2. Tipik yapı
92 
93```plaintext
94my-monorepo/
95  apps/
96    web/        # frontend Next.js
97    api/        # backend Node.js/Express
98  packages/
99    ui/         # shared component library
100    utils/      # shared functions
101  turbo.json
102  package.json
103```
104 
105### 3. `package.json`'da workspace örneği
106 
107```json
108{
109  "private": true,
110  "workspaces": [
111    "apps/*",
112    "packages/*"
113  ]
114}
115```
116 
117### 4. Paylaşılan kütüphane içe aktarma örneği
118 
119`packages/utils/src/formatDate.ts`'de bir fonksiyonunuz olduğunu varsayalım:
120 
121```ts
122// packages/utils/src/formatDate.ts
123export function formatDate(date: Date): string {
124  return date.toLocaleDateString('en-US');
125}
126```
127 
128Frontend'de:
129 
130```ts
131// apps/web/pages/index.tsx
132import { formatDate } from '@myorg/utils';
133 
134export default function Home() {
135  return <div>Today is {formatDate(new Date())}</div>;
136}
137```
138 
139## Monorepo Ne Zaman Seçilmeli?
140 
141- Birden fazla ilişkili proje üzerinde çalışan orta-büyük ekipler.
142- Kod paylaşımı ve büyük ölçekli refactoring ihtiyacı.
143- Hızla büyüyen ve optimize edilmiş build/test gerektiren projeler.
144 
145## Polyrepo Ne Zaman Seçilmeli?
146 
147- Küçük veya bağımsız projeler.
148- Farklı ürünler üzerinde çalışan ayrı ekipler.
149- Çok kısıtlayıcı erişim politikaları.
150 
151## Sonuç
152 
153Herkes için mükemmel bir çözüm yoktur. Tercih ekip büyüklüğüne, proje karmaşıklığına ve işbirliği ihtiyaçlarına bağlıdır. Önemli olan ödünleşimlerin farkında olmak ve karmaşıklığı yönetmek için doğru araçları seçmektir.
154