@kood/claude-code 0.2.5 → 0.3.0

package/templates/tanstack-start/docs/deployment/index.md

@@ -1,163 +0,0 @@
-# 배포 (Deployment)
-
-> TanStack Start + Nitro v3
-
-@nitro.md
-@vercel.md
-@cloudflare.md
-@railway.md
-
----
-
-## 배포 방식
-
-| 방식 | 설정 | 지원 |
-|------|------|------|
-| 플랫폼 직접 통합 | Vite 플러그인 | Cloudflare, Netlify |
-| Nitro 배포 레이어 | nitro/vite | 모든 Nitro preset |
-
-### 플랫폼별 권장
-
-| 플랫폼 | 방식 | 설정 |
-|--------|------|------|
-| Cloudflare Workers | 직접 통합 | `@cloudflare/vite-plugin` |
-| Cloudflare Pages | Nitro | `cloudflare_pages` |
-| Vercel | Nitro | `vercel` |
-| Railway | Nitro | `node` |
-| Netlify | 직접 통합 | `@netlify/vite-plugin-tanstack-start` |
-
----
-
-## Cloudflare Workers (직접 통합)
-
-```bash
-yarn add -D @cloudflare/vite-plugin wrangler
-```
-
-```typescript
-// vite.config.ts
-import { cloudflare } from '@cloudflare/vite-plugin'
-import { tanstackStart } from '@tanstack/react-start/plugin/vite'
-
-export default defineConfig({
-  plugins: [
-    cloudflare({ viteEnvironment: { name: 'ssr' } }),
-    tanstackStart(),
-    viteReact(),
-  ],
-})
-```
-
-```jsonc
-// wrangler.jsonc
-{
-  "name": "my-app",
-  "compatibility_date": "2024-09-19",
-  "compatibility_flags": ["nodejs_compat"],
-  "main": "@tanstack/react-start/server-entry"
-}
-```
-
-```bash
-yarn build && wrangler deploy
-```
-
----
-
-## Nitro 배포 레이어
-
-```bash
-yarn add nitro@3
-```
-
-```typescript
-// vite.config.ts
-import { nitro } from 'nitro/vite'
-import { tanstackStart } from '@tanstack/react-start/plugin/vite'
-
-export default defineConfig({
-  plugins: [tanstackStart(), nitro(), viteReact()],
-})
-```
-
-```typescript
-// nitro.config.ts
-import { defineNitroConfig } from 'nitro/config'
-
-export default defineNitroConfig({
-  preset: 'vercel',  // vercel, cloudflare_pages, node
-  compatibilityDate: '2024-09-19',
-})
-```
-
-```bash
-yarn build
-# 또는
-NITRO_PRESET=vercel yarn build
-```
-
----
-
-## ⚠️ SSR 이슈 해결
-
-### node:async_hooks 오류
-
-```typescript
-// vite.config.ts
-export default defineConfig({
-  optimizeDeps: { exclude: ['node:async_hooks'] },
-  ssr: { external: ['node:async_hooks'] },
-})
-```
-
-### Prisma 브라우저 번들링
-
-```typescript
-resolve: {
-  alias: {
-    '.prisma/client/index-browser': './node_modules/.prisma/client/index-browser.js',
-  },
-},
-```
-
-### SSR Context Loss (Clerk, MUI)
-
-```typescript
-ssr: {
-  noExternal: [
-    '@clerk/tanstack-react-start',
-    '@mui/material', '@mui/utils', '@mui/styled-engine',
-  ],
-},
-```
-
-### 종합 설정
-
-```typescript
-export default defineConfig({
-  plugins: [tsConfigPaths(), tanstackStart(), viteReact()],
-  resolve: {
-    alias: { '.prisma/client/index-browser': './node_modules/.prisma/client/index-browser.js' },
-  },
-  optimizeDeps: { exclude: ['node:async_hooks'] },
-  ssr: {
-    external: ['node:async_hooks'],
-    noExternal: ['@clerk/tanstack-react-start', '@mui/material'],
-  },
-})
-```
-
----
-
-## 스크립트
-
-```json
-{
-  "scripts": {
-    "dev": "vite dev",
-    "build": "vite build && tsc --noEmit",
-    "start": "node .output/server/index.mjs",
-    "deploy": "yarn build && wrangler deploy"
-  }
-}
-```

package/templates/tanstack-start/docs/deployment/nitro.md

@@ -1,110 +0,0 @@
-# Nitro v3 배포 레이어
-
-> Nitro 3.x
-
-## Quick Reference
-
-```typescript
-// nitro.config.ts
-import { defineNitroConfig } from 'nitro/config'
-
-export default defineNitroConfig({
-  preset: 'vercel',
-  compatibilityDate: '2024-09-19',  // v3 필수
-})
-```
-
-```bash
-yarn add nitro@3
-yarn build
-```
-
----
-
-## Vite 통합
-
-```typescript
-// vite.config.ts
-import { nitro } from 'nitro/vite'
-import { tanstackStart } from '@tanstack/react-start/plugin/vite'
-
-export default defineConfig({
-  plugins: [
-    tanstackStart(),
-    nitro({ preset: 'vercel' }),  // preset 직접 지정 가능
-    viteReact(),
-  ],
-})
-```
-
----
-
-## Preset 목록
-
-### 서버리스/Edge
-
-| Preset | 플랫폼 |
-|--------|--------|
-| `vercel` | Vercel Functions |
-| `vercel-edge` | Vercel Edge Functions |
-| `cloudflare_pages` | Cloudflare Pages |
-| `cloudflare_module` | Cloudflare Workers |
-| `netlify` | Netlify Functions |
-| `aws_lambda` | AWS Lambda |
-
-### Node.js 서버
-
-| Preset | 플랫폼 |
-|--------|--------|
-| `node` | 범용 (Railway, Docker) |
-| `node-cluster` | 클러스터 모드 |
-| `bun` | Bun 런타임 |
-| `deno` | Deno 런타임 |
-
----
-
-## 설정 예시
-
-```typescript
-// nitro.config.ts
-import { defineNitroConfig } from 'nitro/config'
-
-export default defineNitroConfig({
-  preset: 'vercel',
-  compatibilityDate: '2024-09-19',
-  output: { dir: '.output' },
-  minify: true,
-
-  // 외부 패키지 처리
-  externals: ['pg', 'mysql2', 'sharp'],
-
-  // Cloudflare Node.js 호환성
-  cloudflare: { nodeCompat: true },
-
-  // 라우트 규칙
-  routeRules: {
-    '/': { prerender: true },
-    '/products/**': { isr: { expiration: 60 } },
-    '/api/**': { cors: true },
-  },
-})
-```
-
----
-
-## 빌드
-
-```bash
-yarn build
-NITRO_PRESET=vercel yarn build
-DEBUG=nitro:* yarn build  # 상세 로그
-```
-
-## 출력 구조
-
-```
-.output/
-├── server/index.mjs   # 서버 엔트리
-├── public/            # 정적 파일
-└── nitro.json
-```

package/templates/tanstack-start/docs/deployment/railway.md

@@ -1,147 +0,0 @@
-# Railway 배포
-
-## Quick Reference
-
-```typescript
-// nitro.config.ts
-import { defineNitroConfig } from 'nitro/config'
-
-export default defineNitroConfig({
-  preset: 'node',
-  compatibilityDate: '2024-09-19',
-})
-```
-
-```json
-// package.json
-{
-  "scripts": {
-    "build": "vite build && tsc --noEmit",
-    "start": "node .output/server/index.mjs"
-  },
-  "engines": { "node": ">=20.0.0" }
-}
-```
-
-```bash
-railway login && railway init && railway up
-```
-
----
-
-## Railway 설정
-
-```json
-// railway.json
-{
-  "build": { "builder": "NIXPACKS", "buildCommand": "yarn install && yarn build" },
-  "deploy": {
-    "startCommand": "node .output/server/index.mjs",
-    "healthcheckPath": "/health",
-    "restartPolicyType": "ON_FAILURE"
-  }
-}
-```
-
----
-
-## 배포 방법
-
-### GitHub 연동 (권장)
-1. Railway 대시보드 → "Deploy from GitHub repo"
-2. 자동으로 `build`, `start` 스크립트 사용
-
-### CLI
-```bash
-npm install -g @railway/cli
-railway login
-railway init
-railway up
-railway variables set DATABASE_URL="postgresql://..."
-```
-
-### Docker
-```dockerfile
-FROM node:20-alpine AS builder
-WORKDIR /app
-COPY package.json yarn.lock ./
-RUN yarn install --frozen-lockfile
-COPY . .
-RUN yarn build
-
-FROM node:20-alpine
-WORKDIR /app
-COPY --from=builder /app/.output ./.output
-ENV PORT=3000 NODE_ENV=production
-CMD ["node", ".output/server/index.mjs"]
-```
-
----
-
-## 환경변수
-
-| 변수 | 설명 |
-|------|------|
-| `PORT` | 서버 포트 (자동) |
-| `RAILWAY_ENVIRONMENT` | production/staging |
-| `RAILWAY_SERVICE_NAME` | 서비스 이름 |
-
----
-
-## 데이터베이스
-
-```bash
-# Railway 대시보드: New → Database → PostgreSQL/Redis
-# DATABASE_URL, REDIS_URL 자동 연결
-```
-
----
-
-## 헬스체크
-
-```typescript
-// server/api/health.ts
-export default defineHandler(() => ({
-  status: 'ok',
-  timestamp: new Date().toISOString(),
-}))
-```
-
----
-
-## CI/CD
-
-```yaml
-# .github/workflows/railway.yml
-- run: npm install -g @railway/cli
-- run: railway up
-  env:
-    RAILWAY_TOKEN: ${{ secrets.RAILWAY_TOKEN }}
-```
-
----
-
-## 모니터링
-
-```bash
-railway logs       # 로그 확인
-railway logs -f    # 실시간 로그
-railway status     # 서비스 상태
-railway variables  # 환경변수 확인
-```
-
----
-
-## 트러블슈팅
-
-| 문제 | 해결 |
-|------|------|
-| 빌드 실패 | `yarn.lock` 커밋 확인 |
-| 포트 바인딩 | `process.env.PORT` 사용 |
-| 메모리 초과 | 리소스 제한 증가 |
-| 헬스체크 실패 | `/health` 엔드포인트 추가 |
-
-```typescript
-// ❌ const port = 3000
-// ✅ const port = process.env.PORT || 3000
-```

package/templates/tanstack-start/docs/deployment/vercel.md

@@ -1,135 +0,0 @@
-# Vercel 배포
-
-## Quick Reference
-
-```typescript
-// nitro.config.ts
-import { defineNitroConfig } from 'nitro/config'
-
-export default defineNitroConfig({
-  preset: 'vercel',
-  compatibilityDate: '2024-09-19',
-})
-```
-
-```json
-// vercel.json
-{
-  "buildCommand": "yarn build",
-  "outputDirectory": ".vercel/output"
-}
-```
-
-```bash
-vercel login && vercel
-```
-
----
-
-## Nitro 설정
-
-```typescript
-// Edge Functions
-preset: 'vercel-edge'
-
-// Bun 런타임
-vercel: { functions: { runtime: 'bun@1' } }
-```
-
----
-
-## vercel.json
-
-```json
-{
-  "buildCommand": "yarn build",
-  "outputDirectory": ".vercel/output",
-  "framework": null,
-  "functions": {
-    "api/**/*.ts": { "memory": 1024, "maxDuration": 30 }
-  }
-}
-```
-
----
-
-## 배포 방법
-
-### GitHub 연동
-1. Vercel 대시보드 → GitHub 저장소 연결
-2. Build: `yarn build`, Output: `.vercel/output`
-
-### CLI
-```bash
-npm install -g vercel
-vercel login
-vercel        # 프리뷰
-vercel --prod # 프로덕션
-```
-
----
-
-## ISR
-
-```typescript
-// nitro.config.ts
-routeRules: {
-  '/products/**': { isr: { expiration: 60 } },  // 60초 재검증
-  '/api/user/**': { isr: false },                // 캐시 안함
-}
-```
-
----
-
-## 환경변수
-
-| 변수 | 설명 |
-|------|------|
-| `VERCEL` | Vercel 환경 ("1") |
-| `VERCEL_ENV` | production/preview/development |
-| `VERCEL_URL` | 배포 URL |
-
-```bash
-vercel env add DATABASE_URL
-vercel env pull .env.local
-```
-
----
-
-## CI/CD
-
-```yaml
-# .github/workflows/vercel.yml
-- uses: amondnet/vercel-action@v25
-  with:
-    vercel-token: ${{ secrets.VERCEL_TOKEN }}
-    vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
-    vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
-    vercel-args: ${{ github.ref == 'refs/heads/main' && '--prod' || '' }}
-```
-
----
-
-## 최적화
-
-```typescript
-// Cold Start 최소화
-minify: true
-externals: ['sharp', 'prisma', '@prisma/client']
-```
-
----
-
-## 트러블슈팅
-
-| 문제 | 해결 |
-|------|------|
-| Timeout | `maxDuration` 증가 |
-| Edge 호환성 | Edge API로 변경 |
-| 환경변수 누락 | 대시보드에서 설정 |
-
-```bash
-vercel dev      # 로컬 시뮬레이션
-vercel logs     # 로그 확인
-vercel inspect  # 함수 상태
-```