În App Router, structura folderelor din app/ definește rutele tale — nu există nicio configurație de router de scris. Fiecare folder este un segment de URL, iar fișierele speciale din el definesc ce randează acel segment.
app/
page.tsx → /
about/page.tsx → /about
blog/page.tsx → /blog
blog/[slug]/page.tsx → /blog/:slug (dynamic segment)
shop/(sale)/page.tsx → /shop (route group — parentheses don't add to URL)
Fiecare folder poate conține nume de fișiere rezervate, fiecare cu un rol specific:
page.tsx → the route's UI (REQUIRED to make a segment routable)
layout.tsx → shared wrapper that persists across child routes
loading.tsx → loading UI (auto-wraps the page in <Suspense>)
error.tsx → error boundary for the segment
not-found.tsx→ 404 UI
route.ts → an API endpoint (instead of a page)
// app/blog/[slug]/page.tsx → matches /blog/hello, /blog/anything
export default function Post({ params }: { params: { slug: string } }) {
return <h1>Post: {params.slug}</h1>; // params.slug = "hello"
}
Parantezele pătrate creează un parametru dinamic transmis paginii via params. Variații: [...slug] (catch-all), [[...slug]] (catch-all opțional).
app/(marketing)/about/page.tsx → /about (the (marketing) folder is ignored in the URL)
Parantezele obișnuite creează grupuri de rută pentru a organiza fișiere sau pentru a aplica diferite aspecte fără a afecta URL-ul.
Rutarea bazată pe fișiere face structura URL evidentă din arborele de fișiere — nicio configurație centrală de rută de păstrat și menținut sincronizat.
Cunoașterea numelor de fișiere speciale (page, layout, loading, error, route) și a convențiilor cu paranteze ([param], [...catchAll], (group)) este vocabularul fundamental al construirii oricărei aplicații App Router.