Next.js 도구
우선순위: P2 (중간)
구조
project/
├── .next/ # 빌드 산출물
├── next.config.js # 고급 설정
└── .eslintrc.json # Next 플러그인
구현 지침
- 빌드 아키텍처:
Turbopack (최신) 또는 Webpack (레거시)을 사용하세요. 빠른 증분 개발을 위해 --turbo 를 활성화하세요.
- 축소화: 최적화된 Docker 배포를 위해
next.config.js에서 output: 'standalone' 을 설정하세요. 자산 크기 축소를 위해 ProGuard / Uglify 에 상응하는 도구를 사용하세요.
- 린팅: CI/CD 파이프라인에
next lint (Next.js ESLint 플러그인)와 tsc (타입 검사) 를 필수로 포함하세요.
- 자산 최적화:
@next/bundle-analyzer 로 크기를 검사하세요. next/image 를 통해 이미지를 최적화하고 사용하지 않는 종속성을 제거하세요.
- 텔레메트리: 프라이버시가 필요하면
next telemetry disable 을 통해 옵트아웃하세요.
- 환경: Next.js에서
.env 관리를 사용하세요 (서버 전용 vs NEXT_PUBLIC_*). 런타임에 Zod로 스키마를 검증하세요.
- CI/CD: CI에서
.next/cache 폴더를 캐싱하여 빌드 시간을 50% 이상 단축하세요.
안티패턴
- 개발 시
npm run start 사용 금지: next dev (또는 next dev --turbo)를 사용하세요.
- 검사되지 않은 번들 증가 금지: 배포 전에
@next/bundle-analyzer로 분석하세요.
- 플러그인 대신 사용자 정의 ESLint 규칙 금지: Next.js 인식 린팅을 위해
eslint-plugin-next를 사용하세요.
- 프로덕션에서
console.log 사용 금지: 구조화된 로거(Pino, Winston)를 사용하세요.
참고 자료