App Router'da app/ içindeki klasör yapısı rotalarınızı tanımlar — yazmanız gereken yönlendirici yapılandırması yoktur. Her klasör bir URL segmentidir ve içindeki özel dosyalar o segmentin neyi render edeceğini tanımlar.
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)
Her klasör ayrılmış dosya adlarını içerebilir ve her birinin belirli bir rolü vardır:
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"
}
Köşeli parantezler params aracılığıyla sayfaya aktarılan dinamik bir parametre oluşturur. Varyasyonlar: [...slug] (tümünü yakala), [[...slug]] (isteğe bağlı tümünü yakala).
app/(marketing)/about/page.tsx → /about (the (marketing) folder is ignored in the URL)
Yuvarlatılmış parantezler rota grupları oluşturur - dosyaları düzenlemek veya URL'yi etkilemeden farklı layoutlar uygulamak için.
Dosya tabanlı yönlendirme, URL yapısını dosya ağacından açık hale getirir — bakım yapılması ve senkronizasyonda tutulması gereken merkezi bir rota yapılandırması yoktur.
Özel dosya adlarını (page, layout, loading, error, route) ve köşeli parantez kurallarını ([param], [...catchAll], (group)) bilmek, herhangi bir App Router uygulaması oluşturmanın temel sözvarlığıdır.