Route Groups

라우트 그룹 화면 구조

(group) 폴더는 URL에 나타나지 않는다. 마케팅, 앱, 인증처럼 서로 다른 layout 체계를 같은 URL 깊이 안에서 분리할 때 유용하다.

01

URL과 구조 분리

사용자에게 보이는 경로는 유지하면서 코드와 layout 책임만 그룹으로 나눈다.

02

서로 다른 shell을 격리한다

admin과 public 화면처럼 전역 frame이 다른 영역은 route group으로 충돌을 줄인다.

03

고급 라우팅은 이유를 남긴다

parallel이나 intercepting route는 강력하지만 팀이 읽기 어려우므로 사용 시나리오를 문서화한다.

group
비URL 분류 (marketing)/about은 URL에서 /about으로 보인다.
이름은 구조 설명용이다.
multiple root
다른 root layout 그룹별로 서로 다른 최상위 경험을 구성할 수 있다.
전체 navigation 전환 비용을 본다.
parallel routes
독립 슬롯 @modal, @feed처럼 여러 영역을 같은 layout에서 별도로 렌더링한다.
fallback과 refresh 경험이 중요하다.
intercept
맥락 보존 리스트 위 modal 상세처럼 현재 화면 맥락을 유지하며 다른 route를 보여 준다.
직접 진입 URL도 처리해야 한다.

URL · 복잡도 · 직접 진입 점검

URL 그룹 폴더명이 실제 경로에 나타나지 않는다는 점을 고려했는가.
복잡도 route group 없이도 단순 layout 중첩으로 충분하지 않은가.
직접 진입 modal/intercept 경로를 새로고침하거나 직접 열어도 의미 있는 화면이 나오는가.

그룹 구조

app/(marketing)/layout.tsx
app/(marketing)/pricing/page.tsx
app/(app)/dashboard/page.tsx