No App Router, a estrutura de pastas dentro de app/ define suas rotas — não há configuração de roteador para escrever. Cada pasta é um segmento de URL, e arquivos especiais nela definem o que esse segmento renderiza.
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)
Cada pasta pode conter nomes de arquivo reservados, cada um com uma função específica:
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"
}
Colchetes criam um parâmetro dinâmico passado para a página via params. Variações: [...slug] (catch-all), [[...slug]] (catch-all opcional).
app/(marketing)/about/page.tsx → /about (the (marketing) folder is ignored in the URL)
Parênteses criam grupos de rota para organizar arquivos ou aplicar layouts diferentes sem afetar a URL.
O roteamento baseado em arquivos torna a estrutura de URL óbvia pela árvore de arquivos — nenhuma configuração central de rota para manter e manter sincronizada.
Conhecer os nomes de arquivo especiais (page, layout, loading, error, route) e as convenções de colchetes ([param], [...catchAll], (group)) é o vocabulário principal para construir qualquer aplicativo App Router.