모노레포 가이드 - 설정 파일 역할 총정리

이 문서는 Next.js + Turborepo + pnpm 모노레포의 모든 설정 파일을 상세히 설명합니다.

📂 루트 (Root)

1. package.json의 역할

📍 위치

your-monorepo/
└── package.json  ← 여기!

🎯 주요 역할

1-1. 워크스페이스 총괄 관리자

{
  "name": "chat",
  "private": true,
  "scripts": {
    "build": "turbo run build",
    "dev": "turbo run dev",
    "lint": "turbo run lint"
  }
}

의미:

• "private": true → npm에 배포 방지 (모노레포는 배포 안 함)
• "turbo run build" → 모든 워크스페이스의 build 스크립트 실행
• 루트에서 pnpm build → apps/web, packages/ui 등 모두 빌드

1-2. 공통 개발 도구 관리

{
  "devDependencies": {
    "prettier": "^3.6.2",    // 전체 프로젝트 코드 포맷팅
    "turbo": "^2.6.0",       // 모노레포 빌드 도구
    "typescript": "^5.9.2"   // 공통 TypeScript 버전
  }
}

왜 여기에?

• ✅ Prettier: 모든 코드 파일 포맷팅 (apps, packages 공통)
• ✅ Turbo: 빌드 오케스트레이션 (루트에서만 실행)
• ✅ TypeScript: 모든 워크스페이스에서 동일한 버전 사용