feat : turborepo 기본 설정

.github/workflows/build.yml

@@ -27,8 +27,13 @@ jobs:
     steps:
       - uses: actions/checkout@v3
 
+      - name: Install pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 9
+
       - name: Install Vercel CLI
-        run: npm install --global vercel@latest
+        run: pnpm add --global vercel@latest
 
       - name: Pull Vercel Environment Information
         run: vercel pull --yes --environment=${{ env.VERCEL_ENV }} --token=${{ secrets.VERCEL_TOKEN }}

.github/workflows/ci.yml

@@ -14,17 +14,22 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
 
+      - name: Install pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 9
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: "22.x"
-          cache: "npm"
+          cache: "pnpm"
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Run ESLint (includes Prettier) & TypeScript
-        run: npm run ci:check
+        run: pnpm run ci:check
 
   build:
     name: Build Verification
@@ -34,16 +39,21 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
 
+      - name: Install pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 9
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: "22.x"
-          cache: "npm"
+          cache: "pnpm"
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Build Next.js application
-        run: npm run build
+        run: pnpm run build
         env:
           NODE_ENV: production

.github/workflows/release.yml

@@ -42,8 +42,13 @@ jobs:
     steps:
       - uses: actions/checkout@v3
 
+      - name: Install pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 9
+
       - name: Install Vercel CLI
-        run: npm install --global vercel@latest
+        run: pnpm add --global vercel@latest
 
       - name: Pull Vercel Environment Information
         run: vercel pull --yes --environment=${{ env.VERCEL_ENV }} --token=${{ secrets.VERCEL_TOKEN }}

.gitignore

@@ -37,3 +37,6 @@ next-env.d.ts
 
 # Sentry Config File
 .sentryclirc
+
+# Turborepo
+.turbo

.husky/commit-msg

@@ -1,2 +1,2 @@
-npx --no -- commitlint --edit ${1}
+pnpm dlx commitlint --edit ${1}
 

.husky/pre-push

@@ -1,7 +1,7 @@
 echo "🔍 Running lint check before push..."
-npm run lint
+pnpm run lint
 
 echo "🔍 Running type check before push..."
-npm run typecheck
+pnpm run typecheck
 
 echo "✅ All checks passed!"

.npmrc

@@ -0,0 +1,9 @@
+# Next.js 호환성을 위한 설정
+shamefully-hoist=true
+auto-install-peers=true
+strict-peer-dependencies=false
+
+# 기본 설정
+registry=https://registry.npmjs.org/
+enable-pre-post-scripts=true
+lockfile=true

README.md

@@ -9,10 +9,47 @@
 - Prettier
 - Vercel
 
+## Prerequisites
+
+- Node.js 22.x
+- pnpm 9.x or later
+
+## Installation
+
+This project uses pnpm as the package manager.
+
+```bash
+# Install pnpm globally
+npm install -g pnpm
+
+# Install dependencies
+pnpm install
+```
+
 ## Commands
 
 ```bash
-npm run dev
+# Development server
+pnpm run dev
 
-npm run lint
+# Build for production
+pnpm run build
+
+# Linting
+pnpm run lint
+
+# Type checking
+pnpm run typecheck
+
+# Format code
+pnpm run format
+```
+
+## Migration from npm
+
+If you have an existing clone:
+
+```bash
+rm -rf node_modules package-lock.json
+pnpm install
 ```

apps/web/.eslintignore

@@ -0,0 +1,26 @@
+# Dependencies
+node_modules
+
+# Build outputs
+.next
+out
+build
+dist
+
+# Generated files
+*.min.js
+*.min.css
+next-env.d.ts
+
+# Cache
+.cache
+.turbo
+
+# Coverage
+coverage
+
+# Vercel
+.vercel
+
+# Documentation
+클로드.md

apps/web/.eslintrc.js

@@ -0,0 +1,134 @@
+/**
+ * ESLint 설정 파일
+ * Next.js + TypeScript 프로젝트용
+ *
+ * 주요 설정:
+ * - TypeScript 파서 사용
+ * - Next.js 및 TypeScript 권장 규칙 적용
+ * - Prettier와의 충돌 방지
+ */
+module.exports = {
+  root: true,
+  parser: "@typescript-eslint/parser",
+  parserOptions: {
+    ecmaVersion: "latest",
+    sourceType: "module",
+    project: "./tsconfig.json",
+  },
+  env: {
+    browser: true,
+    es2021: true,
+    node: true,
+  },
+  plugins: ["@typescript-eslint", "prettier"],
+  extends: [
+    // Next.js 기본 설정
+    "next",
+    // Next.js TypeScript 설정 (plugin:@typescript-eslint/recommended 기반)
+    "next/typescript",
+    // TypeScript ESLint 권장 규칙
+    "plugin:@typescript-eslint/recommended",
+    // Prettier를 ESLint 규칙으로 실행
+    "plugin:prettier/recommended",
+  ],
+  overrides: [
+    {
+      // 설정 파일들은 TypeScript 프로젝트에 포함되지 않으므로 project 옵션 비활성화
+      env: {
+        node: true,
+      },
+      files: [".eslintrc.{js,cjs}", "*.config.{js,mjs,ts}"],
+      parserOptions: {
+        sourceType: "script",
+        project: null,
+      },
+    },
+  ],
+  rules: {
+    // ==========================================
+    // React 관련 규칙
+    // ==========================================
+
+    // JSX 사용 시 React import 불필요 (React 17+)
+    "react/react-in-jsx-scope": "off",
+
+    // JSX 허용 파일 확장자
+    "react/jsx-filename-extension": [1, { extensions: [".js", ".jsx", ".tsx"] }],
+
+    // defaultProps 필수 여부 비활성화
+    "react/require-default-props": "off",
+
+    // 함수 컴포넌트는 화살표 함수로 정의
+    "react/function-component-definition": [1, { namedComponents: "arrow-function" }],
+
+    // ==========================================
+    // Import 관련 규칙
+    // ==========================================
+
+    // import 순서는 Prettier 플러그인에서 처리
+    "import/order": "off",
+
+    // import 시 파일 확장자 생략 (warning으로 설정)
+    "import/extensions": "off",
+
+    // 단일 export 시 default export 권장 (warning)
+    "import/prefer-default-export": "off",
+
+    // ==========================================
+    // 일반 JavaScript 규칙
+    // ==========================================
+
+    // console.log 허용 (개발 편의)
+    "no-console": "off",
+
+    // alert 허용
+    "no-alert": "off",
+
+    // 정의 전 사용 허용 (TypeScript에서 처리)
+    "no-use-before-define": "off",
+
+    // 미사용 변수 - 기본 규칙 비활성화 (TypeScript 규칙과 충돌 방지)
+    "no-unused-vars": "off",
+
+    // ==========================================
+    // TypeScript 관련 규칙
+    // ==========================================
+
+    // 미사용 변수 경고 (TypeScript용 - 기본 규칙 대신 사용)
+    "@typescript-eslint/no-unused-vars": "warn",
+
+    // any 타입 사용 경고 (error -> warn)
+    "@typescript-eslint/no-explicit-any": "warn",
+
+    // any 타입 관련 규칙 (경고로 설정)
+    "@typescript-eslint/no-unsafe-assignment": "warn",
+    "@typescript-eslint/no-unsafe-member-access": "warn",
+    "@typescript-eslint/no-unsafe-return": "warn",
+    "@typescript-eslint/no-unsafe-call": "warn",
+    "@typescript-eslint/no-unsafe-argument": "warn",
+
+    // ==========================================
+    // 접근성 (a11y) 관련 규칙
+    // ==========================================
+
+    // label과 control 연결 규칙 비활성화
+    "jsx-a11y/label-has-associated-control": "off",
+
+    // 클릭 이벤트에 키보드 이벤트 필요 (경고)
+    "jsx-a11y/click-events-have-key-events": "warn",
+
+    // 정적 요소에 이벤트 핸들러 (경고)
+    "jsx-a11y/no-static-element-interactions": "warn",
+  },
+  settings: {
+    "import/parsers": {
+      "@typescript-eslint/parser": [".ts", ".tsx"],
+    },
+    "import/resolver": {
+      typescript: {
+        alwaysTryTypes: true,
+        project: "./tsconfig.json",
+      },
+    },
+  },
+};

apps/web/.next/app-build-manifest.json

@@ -0,0 +1,31 @@
+{
+  "pages": {
+    "/global-error": [
+      "static/chunks/webpack.js",
+      "static/chunks/main-app.js",
+      "static/chunks/app/global-error.js"
+    ],
+    "/(home)/page": [
+      "static/chunks/webpack.js",
+      "static/chunks/main-app.js",
+      "static/chunks/app/(home)/page.js"
+    ],
+    "/(home)/layout": [
+      "static/chunks/webpack.js",
+      "static/chunks/main-app.js",
+      "static/chunks/app/(home)/layout.js"
+    ],
+    "/layout": [
+      "static/chunks/webpack.js",
+      "static/chunks/main-app.js",
+      "static/css/styles.css",
+      "static/chunks/styles.js",
+      "static/chunks/app/layout.js"
+    ],
+    "/not-found": [
+      "static/chunks/webpack.js",
+      "static/chunks/main-app.js",
+      "static/chunks/app/not-found.js"
+    ]
+  }
+}

apps/web/.next/build-manifest.json

@@ -0,0 +1,19 @@
+{
+  "polyfillFiles": [
+    "static/chunks/polyfills.js"
+  ],
+  "devFiles": [],
+  "ampDevFiles": [],
+  "lowPriorityFiles": [
+    "static/development/_buildManifest.js",
+    "static/development/_ssgManifest.js"
+  ],
+  "rootMainFiles": [
+    "static/chunks/webpack.js",
+    "static/chunks/main-app.js"
+  ],
+  "pages": {
+    "/_app": []
+  },
+  "ampFirstPages": []
+}

apps/web/.next/package.json

@@ -0,0 +1 @@
+{"type": "commonjs"}

apps/web/.next/react-loadable-manifest.json

@@ -0,0 +1 @@
+{}