- Removed `.claude/` from .gitignore - Updated index.md to reflect the addition of 7 new wiki pages, increasing total pages to 11 - Added detailed summaries for new pages including rendering modes, lifecycle, routing, data fetching, state management, auto imports, layers, performance, and runtime config - Created nuxt-runtime-config.md to document runtime configuration and environment variable handling - Updated log.md to include entries for newly created wiki pages
2.8 KiB
2.8 KiB
Nuxt 개발 지식 위키 — 전체 목차
마지막 업데이트: 2026-05-13 총 페이지: 11개 | 총 raw 자료: 6개
핵심 개념
Nuxt 라이프사이클, 렌더링 모드, 라우팅, 레이어 등 Nuxt의 근본 동작 원리
| 페이지 | 요약 |
|---|---|
| nuxt-rendering-modes | Universal SSR, CSR, Hybrid, Prerendering, Edge-Side Rendering 비교와 routeRules 설정 |
| nuxt-lifecycle | 서버·클라이언트 라이프사이클 순서, 실행 환경 분기, 하이드레이션 주의사항 |
| nuxt-routing | 파일 기반 라우팅, 동적 라우트, 미들웨어 3종류, validate, definePageMeta |
| nuxt-data-fetching | $fetch·useFetch·useAsyncData 비교, lazy/server/watch/pick 옵션, 캐시 key 전략 |
| nuxt-state-management | useState 패턴, callOnce 초기화, Pinia 통합, 공유 상태 composable |
| nuxt-auto-imports | 자동 임포트 대상·제약·설정, 서드파티 패키지 임포트, 명시적 임포트 |
| nuxt-layers | 레이어 설정·우선순위·오버라이드, DDD 모듈화, npm·GitHub 레이어 확장 |
패턴 & 레시피
Composable 패턴, 상태관리, 폼 처리 등 실전에서 재사용 가능한 솔루션
| 페이지 | 요약 |
|---|---|
| claude-code-overview | Claude Code 핵심 개념 — 에이전트 루프, 컨텍스트 윈도우, 효과적인 프롬프트 작성 |
| claude-code-project-setup | CLAUDE.md, Skills, Subagents, MCP 설정 가이드 및 컴포넌트 선택 기준 |
| claude-code-hooks | Hooks 핸들러 3종류, 프로덕션 패턴, CI/CD 통합, 단계별 도입 로드맵 |
| claude-code-workflow-patterns | Sequential·Operator·Split-and-Merge·Agent Teams·Headless 5가지 패턴 + 장기 실행 Harness |
모듈 & 에코시스템
Nuxt 모듈, Nitro, UnJS(H3, ofetch, defu 등) 사용법과 내부 구조
| 페이지 | 요약 |
|---|---|
| (아직 없음) |
트러블슈팅
에러 사례, 삽질 기록, 버전별 Breaking Change, 해결책
| 페이지 | 요약 |
|---|---|
| (아직 없음) |
성능 & 배포
번들 최적화, 캐싱 전략, CI/CD, 호스팅 환경별 설정
| 페이지 | 요약 |
|---|---|
| nuxt-performance | Lazy 컴포넌트·Hydration, NuxtImage·Fonts·Scripts, 하이드레이션 오류 5가지 원인과 해결 |
| nuxt-runtime-config | runtimeConfig 서버/public 분리, 환경 변수 오버라이드 규칙, TypeScript 타입 추가 |
아키텍처 결정
ADR, 설계 고민, 트레이드오프 기록, 패턴 선택 근거
| 페이지 | 요약 |
|---|---|
| (아직 없음) |
빠른 탐색
- 최신 추가 항목 → log 참고
- 특정 에러 해결 → 트러블슈팅 섹션
- 코드 패턴 찾기 → 패턴 & 레시피 섹션