In de App Router definieert de mappenstructuur in app/ uw routes — u hoeft geen routerconfiguratie te schrijven. Elke map is een URL-segment, en speciale bestanden erin bepalen wat dat segment weergeeft.
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)
Elke map kan gereserveerde bestandsnamen bevatten, elk met een specifieke rol:
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"
}
Vierkante haakjes creëren een dynamische parameter die via params aan de pagina wordt doorgegeven. Variaties: [...slug] (catch-all), [[...slug]] (optioneel catch-all).
app/(marketing)/about/page.tsx → /about (the (marketing) folder is ignored in the URL)
Haakjes creëren routegroepen om bestanden te organiseren of verschillende layouts toe te passen zonder de URL te beïnvloeden.
File-based routing maakt de URL-structuur duidelijk uit de bestandsboom — geen centrale routeconfiguratie die u moet onderhouden en gesynchroniseerd moet houden.
Het kennen van de speciale bestandsnamen (page, layout, loading, error, route) en de haakjesconventies ([param], [...catchAll], (group)) is de kernvocabulaire van het bouwen van een App Router-app.