중첩 빌드 지도

중첩 라우트는 레벨별 파일을 함께 배치한다

URL segment를 깊게 만들수록 layout, page, 상태 파일의 책임을 같은 라우트 계층 안에서 읽을 수 있어야 합니다.

root

앱 전체 경계

전역 navigation, metadata, provider처럼 모든 URL에 필요한 요소를 둡니다.

app/layout.tsx

html과 body를 포함하는 최상위 layout

dashboard

구간 유지 영역

사이드바, 탭, 공통 필터처럼 하위 페이지 이동에도 남을 UI를 둡니다.

dashboard/layout.tsx

dashboard 하위 route의 공통 shell

leaf

URL별 본문

overview, analytics, settings처럼 실제로 바뀌는 화면 콘텐츠를 둡니다.

settings/page.tsx

현재 URL의 page 컴포넌트

대기

loading.tsx로 구간별 로딩 표시

오류

error.tsx로 실패 범위 제한

없음

not-found.tsx로 404 처리

데이터

공유 여부에 따라 layout 또는 page에 배치