📋 npm workspaces (package.json)

{
  "name": "my-monorepo",
  "private": true,
  "workspaces": [
    "packages/*",
    "apps/*"
  ]
}

📋 pnpm-workspace.yaml

packages:
  - 'packages/*'
  - 'apps/*'
  - '!**/test/**'

📁 권장 모노레포 폴더 구조

my-monorepo/
├── apps/                    # 실제 배포되는 앱들
│   ├── web/                 # Next.js 웹 앱
│   ├── mobile/              # React Native 앱
│   └── admin/               # 관리자 대시보드
├── packages/                # 공유 패키지들
│   ├── ui/                  # 공통 UI 컴포넌트
│   ├── utils/               # 공통 유틸리티 함수
│   ├── types/               # 공통 TypeScript 타입
│   ├── config/              # 공통 설정 (ESLint, TS 등)
│   └── api-client/          # API 클라이언트
├── tooling/                 # 개발 도구 설정
│   ├── eslint-config/       # 공통 ESLint 설정
│   └── tsconfig/            # 공통 TypeScript 설정
├── package.json             # 루트 package.json
├── pnpm-workspace.yaml      # pnpm 워크스페이스 설정
├── turbo.json               # Turborepo 설정
└── .changeset/              # Changesets 설정

📋 루트 package.json

{
  "name": "my-monorepo",
  "private": true,
  "scripts": {
    "build": "turbo run build",
    "dev": "turbo run dev --parallel",
    "lint": "turbo run lint",
    "test": "turbo run test",
    "type-check": "turbo run type-check",
    "clean": "turbo run clean && rm -rf node_modules"
  },
  "devDependencies": {
    "turbo": "^2.0.0",
    "typescript": "^5.0.0"
  },
  "engines": {
    "node": ">=18.0.0",
    "pnpm": ">=8.0.0"
  },
  "packageManager": "pnpm@8.15.0"
}

📋 turbo.json

{
  "$schema": "https://turbo.build/schema.json",
  "globalDependencies": ["**/.env.*local"],
  "pipeline": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": [".next/**", "dist/**", "build/**"],
      "cache": true
    },
    "dev": {
      "dependsOn": ["^build"],
      "cache": false,
      "persistent": true
    },
    "lint": {
      "outputs": [],
      "cache": true
    },
    "test": {
      "dependsOn": ["build"],
      "outputs": ["coverage/**"],
      "cache": true
    },
    "type-check": {
      "dependsOn": ["^type-check"],
      "cache": true
    },
    "clean": {
      "cache": false
    }
  }
}

📋 packages/ui/package.json

{
  "name": "@my-monorepo/ui",
  "version": "0.1.0",
  "private": false,
  "main": "./dist/index.js",
  "module": "./dist/index.mjs",
  "types": "./dist/index.d.ts",
  "exports": {
    ".": {
      "import": "./dist/index.mjs",
      "require": "./dist/index.js",
      "types": "./dist/index.d.ts"
    }
  },
  "scripts": {
    "build": "tsup src/index.ts --format cjs,esm --dts",
    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
    "lint": "eslint src/",
    "type-check": "tsc --noEmit"
  },
  "peerDependencies": {
    "react": "^18.0.0",
    "react-dom": "^18.0.0"
  },
  "devDependencies": {
    "@my-monorepo/eslint-config": "workspace:*",
    "@my-monorepo/tsconfig": "workspace:*",
    "tsup": "^8.0.0",
    "typescript": "^5.0.0"
  }
}

📋 tooling/tsconfig/base.json

{
  "$schema": "https://json.schemastore.org/tsconfig",
  "display": "Default",
  "compilerOptions": {
    "composite": false,
    "declaration": true,
    "declarationMap": true,
    "esModuleInterop": true,
    "forceConsistentCasingInFileNames": true,
    "inlineSources": false,
    "isolatedModules": true,
    "moduleResolution": "bundler",
    "noUnusedLocals": false,
    "noUnusedParameters": false,
    "preserveWatchOutput": true,
    "skipLibCheck": true,
    "strict": true,
    "target": "ES2022"
  },
  "exclude": ["node_modules"]
}

📋 tooling/tsconfig/nextjs.json (Next.js 앱용)

{
  "$schema": "https://json.schemastore.org/tsconfig",
  "display": "Next.js",
  "extends": "./base.json",
  "compilerOptions": {
    "plugins": [{ "name": "next" }],
    "module": "ESNext",
    "moduleResolution": "bundler",
    "allowJs": true,
    "jsx": "preserve",
    "lib": ["dom", "dom.iterable", "esnext"]
  }
}

📋 apps/web/tsconfig.json (실제 앱에서 사용)

{
  "extends": "@my-monorepo/tsconfig/nextjs.json",
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["./src/*"]
    }
  },
  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
  "exclude": ["node_modules"]
}

📋 tooling/eslint-config/index.js

/** @type {import("eslint").Linter.Config} */
module.exports = {
  extends: [
    "eslint:recommended",
    "plugin:@typescript-eslint/recommended",
    "plugin:import/recommended",
    "plugin:import/typescript",
    "prettier"
  ],
  plugins: ["@typescript-eslint", "import"],
  parser: "@typescript-eslint/parser",
  rules: {
    "@typescript-eslint/no-unused-vars": [
      "error",
      { argsIgnorePattern: "^_" }
    ],
    "import/order": [
      "error",
      {
        "groups": [
          "builtin", "external", "internal",
          "parent", "sibling", "index"
        ],
        "newlines-between": "always",
        "alphabetize": { "order": "asc" }
      }
    ]
  }
};

📋 Vercel Remote Cache 설정

# 1. Vercel 로그인
npx turbo login

# 2. 레포지토리 연결
npx turbo link

# 3. 이제 자동으로 원격 캐시 사용!
# CI에서는 환경변수로 설정
TURBO_TOKEN=your_token
TURBO_TEAM=your_team_name

📋 nx.json 캐싱 설정

{
  "$schema": "./node_modules/nx/schemas/nx-schema.json",
  "tasksRunnerOptions": {
    "default": {
      "runner": "nx/tasks-runners/default",
      "options": {
        "cacheableOperations": ["build", "lint", "test", "type-check"],
        "parallel": 3
      }
    }
  },
  "targetDefaults": {
    "build": {
      "dependsOn": ["^build"],
      "inputs": ["production", "^production"],
      "cache": true
    },
    "test": {
      "inputs": ["default", "^production", "{workspaceRoot}/jest.preset.js"],
      "cache": true
    }
  }
}

📋 .github/workflows/ci.yml

name: CI

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main, develop]

env:
  TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
  TURBO_TEAM: ${{ vars.TURBO_TEAM }}

jobs:
  build:
    name: Build & Test
    runs-on: ubuntu-latest
    
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0  # 전체 히스토리 필요 (변경 감지용)
      
      - name: Setup pnpm
        uses: pnpm/action-setup@v3
        with:
          version: 8
      
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: 'pnpm'
      
      - name: Install dependencies
        run: pnpm install --frozen-lockfile
      
      - name: Type check
        run: pnpm turbo run type-check
      
      - name: Lint
        run: pnpm turbo run lint
      
      - name: Build
        run: pnpm turbo run build
      
      - name: Test
        run: pnpm turbo run test

📋 변경된 패키지 감지 스크립트

# Turborepo로 변경된 패키지 목록 확인
turbo run build --dry=json | jq '.packages'

# 또는 git diff로 직접 확인
git diff --name-only HEAD~1 HEAD | \
  grep -E '^(apps|packages)/' | \
  cut -d'/' -f1-2 | \
  sort -u

📋 선택적 배포 GitHub Actions

jobs:
  detect-changes:
    runs-on: ubuntu-latest
    outputs:
      web: ${{ steps.changes.outputs.web }}
      mobile: ${{ steps.changes.outputs.mobile }}
    steps:
      - uses: actions/checkout@v4
      - uses: dorny/paths-filter@v3
        id: changes
        with:
          filters: |
            web:
              - 'apps/web/**'
              - 'packages/ui/**'
              - 'packages/utils/**'
            mobile:
              - 'apps/mobile/**'
              - 'packages/utils/**'

  deploy-web:
    needs: detect-changes
    if: needs.detect-changes.outputs.web == 'true'
    runs-on: ubuntu-latest
    steps:
      - name: Deploy Web App
        run: echo "웹 앱 배포!"
        # 실제 배포 명령어

  deploy-mobile:
    needs: detect-changes
    if: needs.detect-changes.outputs.mobile == 'true'
    runs-on: ubuntu-latest
    steps:
      - name: Deploy Mobile App
        run: echo "모바일 앱 배포!"

📋 .github/CODEOWNERS

# 전체 레포 기본 소유자
*                           @org/platform-team

# 앱별 소유자
apps/web/**                 @org/frontend-team
apps/mobile/**              @org/mobile-team
apps/admin/**               @org/admin-team

# 공유 패키지 소유자
packages/ui/**              @org/design-system-team
packages/utils/**           @org/platform-team
packages/api-client/**      @org/backend-team

# 인프라 설정
.github/**                  @org/devops-team
turbo.json                  @org/devops-team

📋 eslint-plugin-boundaries 설정

// .eslintrc.js
module.exports = {
  plugins: ["boundaries"],
  settings: {
    "boundaries/elements": [
      { type: "app", pattern: "apps/*" },
      { type: "ui", pattern: "packages/ui" },
      { type: "utils", pattern: "packages/utils" },
      { type: "types", pattern: "packages/types" }
    ]
  },
  rules: {
    "boundaries/element-types": [
      "error",
      {
        default: "disallow",
        rules: [
          // app은 모든 패키지 사용 가능
          { from: "app", allow: ["ui", "utils", "types"] },
          // ui는 utils와 types만 사용 가능
          { from: "ui", allow: ["utils", "types"] },
          // utils는 types만 사용 가능
          { from: "utils", allow: ["types"] },
          // types는 아무것도 import 안 함
          { from: "types", allow: [] }
        ]
      }
    ]
  }
};

📋 루트 Jest 설정 (jest.config.ts)

import type { Config } from 'jest';

const config: Config = {
  projects: [
    '<rootDir>/packages/*/jest.config.ts',
    '<rootDir>/apps/*/jest.config.ts'
  ],
  coverageDirectory: '<rootDir>/coverage',
  collectCoverageFrom: [
    '<rootDir>/packages/*/src/**/*.{ts,tsx}',
    '!**/*.d.ts',
    '!**/node_modules/**'
  ]
};

export default config;

📋 병렬 실행 설정

# turbo.json - 동시 실행 수 제한
{
  "pipeline": {
    "build": {
      "dependsOn": ["^build"]
    }
  }
}

# 실행 시 병렬 수 지정
turbo run build --concurrency=10

# CPU 코어 수 기반 자동 설정
turbo run build --concurrency=50%

📋 packages/utils/tsup.config.ts

import { defineConfig } from 'tsup';

export default defineConfig({
  entry: ['src/index.ts'],
  format: ['cjs', 'esm'],
  dts: true,
  splitting: false,
  sourcemap: true,
  clean: true,
  treeshake: true,
  minify: false,  // 라이브러리는 보통 minify 안 함
  external: ['react', 'react-dom'],  // peer deps는 번들에서 제외
});

📋 루트 tsconfig.json (Project References 사용)

{
  "files": [],
  "references": [
    { "path": "packages/types" },
    { "path": "packages/utils" },
    { "path": "packages/ui" },
    { "path": "apps/web" },
    { "path": "apps/admin" }
  ]
}

// 각 패키지의 tsconfig.json에 composite: true 추가
{
  "compilerOptions": {
    "composite": true,
    "declarationMap": true
  }
}