В чем плюсы и минусы монорепозитория?

Плюсы и минусы монорепозитория

Монорепозиторий (monorepo) - это один Git репозиторий, содержащий несколько проектов, пакетов или микросервисов. Это архитектурное решение имеет значительные преимущества и недостатки.

Плюсы монорепозитория

1. Упрощенное управление зависимостями

Monorepo структура:
my-monorepo/
  packages/
    ui/
      package.json      # @myapp/ui
    api/
      package.json      # @myapp/api
    web/
      package.json      # @myapp/web
  package.json          # root
  pnpm-workspace.yaml   # или npm workspaces

Преимущество: Все пакеты используют одну версию зависимостей:

{
  "dependencies": {
    "react": "^19.0.0"
  }
}

Vs полиреп: Каждый репозиторий может иметь разные версии React, вызывая конфликты

2. Упрощенный рефакторинг и кросс-пакетное изменение

// packages/ui/Button.tsx
export function Button() {
  return <button>Click me</button>;
}

// packages/web/page.tsx - используешь прямо
import { Button } from '@myapp/ui';

export default function Home() {
  return <Button />;
}

Преимущество: Можешь менять оба одновременно в одном коммите

# Один коммит обновляет и Button и его использование
git commit -m "refactor: Button API"

Vs полиреп: Нужно 2 коммита в 2 репозиториях и ждать публикации на npm

3. Проще share кода между проектами

// packages/shared/hooks/useAuth.ts
export function useAuth() {
  const [user, setUser] = useState(null);
  // ...
  return { user, login, logout };
}

// packages/web использует
import { useAuth } from '@myapp/shared';

// packages/mobile тоже может использовать
import { useAuth } from '@myapp/shared';

4. Единая история коммитов и ревизий

git log --oneline
# Можешь видеть всю историю проекта целиком
a3f1e2c (main) refactor: ui package
b2d4c5f feat: add Button component
c1e3a9d fix: auth token storage

5. Упрощенный CI/CD

# .github/workflows/test.yml
name: Test All Packages
on: [push]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - run: npm ci
      - run: npm test          # Тестирует все пакеты
      - run: npm run build     # Собирает все пакеты
      - run: npm run lint      # Линтит все пакеты

6. Целостность между проектами

# Это невозможно: смерджить UI изменение без соответствующих изменений в web
# Потому что оба в одном репозитории
# Это гарантирует consistency между packages

7. Упрощенное обнаружение конфликтов зависимостей

// packages/ui/package.json
{ "dependencies": { "react": "^18.0.0" } }

// packages/web/package.json
{ "dependencies": { "react": "^19.0.0" } }

// Конфликт виден сразу при setup, в полиреп это бага в production

Минусы монорепозитория

1. Размер репозитория растет

# Со временем:
# Полиреп: каждый репо ~50MB
# Монорепо может вырасти до 500MB+

# Это влияет на:
git clone  # Медленнее
git checkout
git log

2. Сложность изоляции и разрешений

# В полиреп:
team-mobile имеет доступ только к mobile/ репо
team-web имеет доступ только к web/ репо

# В монорепо:
# CODEOWNERS помогает, но это не гарантия
packages/mobile/CODEOWNERS: @team-mobile
packages/web/CODEOWNERS: @team-web

# Человек из team-web может случайно изменить mobile код

3. CI/CD становится медленнее

# Полиреп:
git push -> CI тестирует только этот пакет (2 минуты)

# Монорепо:
git push -> CI тестирует ВСЕ пакеты (10 минут)
# Даже если изменения в одном пакете

Решение: Используй инструменты для smart cache:

# Turbo, Nx, Lerna могут тестировать только затронутые пакеты
nx affected:test --base=main   # Тестирует только изменённые пакеты

4. Сложнее различные версии пакетов

// Невозможно иметь две версии @myapp/ui одновременно
// @myapp/web требует v1.0.0
// @myapp/mobile требует v2.0.0
// В монорепо - impossibe без workarounds

5. Сложнее управление릴ize и публикацией

# Полиреп:
npm version patch && npm publish
# Просто, быстро, понятно

# Монорепо:
# Нужно понять: какой пакет изменился?
# Какой бампить версию?
# Нужны инструменты: Lerna, Changesets

6. Более сложная разработка

# Может быть запутанным для новых разработчиков
# "Где я должен положить код?"
# "Какой пакет должен импортировать какой?"
# Нужна хорошая документация

Инструменты для управления монорепо

# Workspaces (встроено в npm, yarn, pnpm)
pnpm-workspace.yaml
npm workspaces (npm 7+)

# Специализированные инструменты:
Nx            # Полнофункциональный, мощный
Turbo         # Быстрый, простой
Lerna         # Для publishing, управления версиями
Mkdir         # Bash пример (шутка)

Когда использовать монорепо

✓ ИСПОЛЬЗУЙ когда:
  - Несколько пакетов с высокой связанностью
  - Один team работает над несколькими пакетами
  - Нужна частая синхронизация между пакетами
  - Shared компоненты/утилиты используются везде
  - Одна версионирование стратегия

✗ НЕ ИСПОЛЬЗУЙ когда:
  - Независимые проекты с разными teams
  - Разные версионирование стратегии
  - Разные деплой графики
  - Разные технологические стеки

Примеры компаний

Монорепо:
- Google (масивный internal monorepo)
- Meta (React, Jest, Yarn, и много чего еще)
- Airbnb
- Microsoft

Полиреп:
- npm - каждый пакет отдельно
- GitHub Projects - разные репозитории

Вывод

Монорепо - мощный инструмент для масштабируемых проектов, но требует:

• Хороших инструментов (Nx, Turbo)
• Четкой архитектуры
• Дисциплины в команде

Простое правило: Используй монорепо если твой код в одном месте должен эволюционировать вместе. Если проекты независимы - полиреп проще.