# 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]] 참고
- 특정 에러 해결 → 트러블슈팅 섹션
- 코드 패턴 찾기 → 패턴 & 레시피 섹션