모노레포는 무엇이고 언제 도입하나요?

# 멀티레포 방식 — 공통 유틸을 각 저장소에 복사하는 경우

# 저장소 A (웹 앱)
my-web-app/
└── src/utils/formatDate.ts   ← 직접 작성

# 저장소 B (어드민)
my-admin/
└── src/utils/formatDate.ts   ← 동일한 함수를 복사

# formatDate 버그 수정 시 두 저장소를 모두 수정해야 합니다.
# 저장소가 늘어날수록 수정 범위가 계속 커집니다.

# npm 패키지로 분리했지만 버전 관리가 번거로운 경우

# 1. 공통 패키지 수정
cd packages/shared-utils
npm version patch       # 버전 올리기
npm publish             # npm에 배포

# 2. 각 저장소에서 버전 업데이트
cd ../my-web-app && npm install shared-utils@1.0.1
cd ../my-admin && npm install shared-utils@1.0.1

# 공통 코드를 한 줄 바꿀 때마다 이 과정을 반복해야 합니다.

# Turborepo + pnpm 기반 모노레포 기본 구조

my-monorepo/
├── apps/
│   ├── web/          ← Next.js 웹 앱
│   └── admin/        ← React 어드민
├── packages/
│   ├── ui/           ← 공통 UI 컴포넌트
│   ├── utils/        ← 공통 유틸 함수
│   └── tsconfig/     ← 공통 TypeScript 설정
├── package.json
├── pnpm-workspace.yaml
└── turbo.json

# pnpm-workspace.yaml
# pnpm이 apps/와 packages/ 아래 폴더를 워크스페이스로 인식합니다.

packages:
  - 'apps/*'
  - 'packages/*'

// packages/utils/package.json
// 로컬 패키지로 선언합니다. npm에 배포하지 않아도 됩니다.

{
  "name": "@my-app/utils",
  "version": "0.0.0",
  "main": "./src/index.ts",
  "exports": {
    ".": "./src/index.ts"
  }
}

// apps/web/package.json
// 로컬 패키지를 workspace 프로토콜로 참조합니다.
// 버전 배포 없이 packages/utils의 코드를 바로 사용합니다.

{
  "name": "web",
  "dependencies": {
    "@my-app/utils": "workspace:*",
    "@my-app/ui": "workspace:*"
  }
}

// turbo.json
// 어떤 태스크가 어떤 태스크에 의존하는지 정의합니다.
// 변경되지 않은 패키지는 캐시를 사용해 빌드를 건너뜁니다.

{
  "$schema": "https://turbo.build/schema.json",
  "tasks": {
    "build": {
      "dependsOn": ["^build"],  // 의존 패키지를 먼저 빌드
      "outputs": [".next/**", "dist/**"]
    },
    "dev": {
      "cache": false,
      "persistent": true
    },
    "lint": {},
    "typecheck": {}
  }
}

# 루트에서 전체 빌드 — Turborepo가 의존성 그래프를 분석해 병렬 실행합니다.
pnpm turbo build

# 특정 앱만 실행
pnpm turbo dev --filter=web

# packages/utils가 변경됐을 때 영향받는 앱만 빌드
pnpm turbo build --filter=...@my-app/utils