Monorepo vs Polyrepo: Ce strategie ar trebui sa alegi?

Cand lucrezi la proiecte software complexe, alegerea intre monorepo si polyrepo poate impacta semnificativ productivitatea echipei.

Ce sunt Monorepo si Polyrepo?

Monorepo

Un monorepo este un singur repozitoriu care contine codul sursa pentru mai multe proiecte.

my-monorepo/
  packages/
    frontend/
    backend/
    shared/
  package.json
  turbo.json

Polyrepo

Un polyrepo inseamna ca fiecare proiect are propriul sau repozitoriu separat.

repos/
  frontend/
    package.json
  backend/
    package.json
  shared/
    package.json

Diferenta vizuala

Avantaje si dezavantaje

Monorepo

Avantaje:

• Faciliteaza partajarea codului.
• Refactorizare atomica pe mai multe proiecte.
• Gestionare centralizata a dependentelor.

Dezavantaje:

• Poate deveni greu pe masura ce baza de cod creste.
• Necesita instrumente pentru gestionarea build-urilor/testelor partiale (ex. Nx, Turborepo).

Polyrepo

Avantaje:

• Fiecare echipa/proiect este independent.
• Mai usor de gestionat pentru proiecte mici.
• Permite politici de acces granulare.

Dezavantaje:

• Mai dificil de partajat cod fara publicarea de pachete.
• Refactorizarea cross-repo este mai complexa.
• Posibila duplicare a configuratiilor.

Exemplu practic: Monorepo cu Turborepo

npx create-turbo@latest

my-monorepo/
  apps/
    web/        # frontend Next.js
    api/        # backend Node.js/Express
  packages/
    ui/         # biblioteca de componente partajata
    utils/      # functii partajate
  turbo.json
  package.json

{
  "private": true,
  "workspaces": [
    "apps/*",
    "packages/*"
  ]
}

// packages/utils/src/formatDate.ts
export function formatDate(date: Date): string {
  return date.toLocaleDateString('en-US');
}

// apps/web/pages/index.tsx
import { formatDate } from '@myorg/utils';

export default function Home() {
  return <div>Today is {formatDate(new Date())}</div>;
}

Cand sa alegi Monorepo?

• Echipe medii-mari care lucreaza pe proiecte conexe.
• Nevoie de partajare a codului si refactorizare la scara larga.
• Proiecte care cresc rapid.

Cand sa alegi Polyrepo?

• Proiecte mici sau independente.
• Echipe separate pe produse diferite.
• Politici de acces foarte restrictive.

Concluzie

Nu exista o solutie perfecta pentru toti. Alegerea depinde de dimensiunea echipei, complexitatea proiectului si nevoile de colaborare.