Files
gil-wiki/wiki/index.md
gil 5070852ab8 docs: update wiki with new pages and content
- 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
2026-05-13 00:34:38 +09:00

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