Astro Routing

Patterns for file-based and dynamic routing in Astro.

File-Based Routes

src/pages/
├── index.astro           -> /
├── about.astro           -> /about
├── blog/
│   ├── index.astro       -> /blog
│   └── [slug].astro      -> /blog/:slug
├── [...slug].astro       -> /* (catch-all)
└── api/
    └── data.json.ts      -> /api/data.json

Dynamic Routes

Single Parameter

---
// src/pages/blog/[slug].astro
import { getCollection } from 'astro:content';

export async function getStaticPaths() {
  const posts = await getCollection('blog');
  return posts.map((post) => ({
    params: { slug: post.slug },
    props: { post },
  }));
}

const { post } = Astro.props;
---
<h1>{post.data.title}</h1>

Multiple Parameters

---
// src/pages/[lang]/blog/[slug].astro
export async function getStaticPaths() {
  const posts = await getCollection('blog');
  const languages = ['en', 'fr'];

  return languages.flatMap((lang) =>
    posts.map((post) => ({
      params: { lang, slug: post.slug },
      props: { post, lang },
    }))
  );
}
---

Route Priority

1. Static routes (/about.astro) -- highest
2. Named parameters (/blog/[slug].astro) -- medium
3. Rest parameters (/[...slug].astro) -- lowest

When implementing nested dynamic routes, catch-all routes, pagination, or API endpoints, read references/routing-examples.md for complete implementations with getStaticPaths, paginate, JSON/RSS endpoints, and redirect patterns.

Quick Reference