komal.nakrani
Browse Themes
ThemesCategoriesDocsBlog
Docs/Getting Started/Project Structure

Project Structure

Where everything lives in an Astro theme, and which directories are special.

Updated: September 2026·License: Commercial & Personal

Directory layout

text
your-theme/
├── public/               # Copied to the build as-is (favicon, fonts, images)
├── src/
│   ├── pages/            # File-based routes — every file here becomes a URL
│   ├── layouts/          # Page shells wrapped around route content
│   ├── components/       # Reusable .astro components
│   ├── content/          # Markdown and MDX collections
│   ├── styles/           # Global stylesheets and design tokens
│   └── content.config.ts # Collection schemas
├── astro.config.mjs      # Astro config and integrations
└── package.json

The two directories that are special

src/pages/ drives routing. There is no route config — the file path *is* the URL:

| File | URL | | --

  • | --- |
    • | src/pages/index.astro | / | | src/pages/about.astro | /about/ | | src/pages/work/[slug].astro | /work/anything/ |

    public/ is copied to the output untouched. A file at public/logo.svg is served at /logo.svg. Put things here only when they must keep their exact filename — everything imported through src/ gets hashed and optimised instead.

    Explore production-ready themes

    Hand-built Astro themes — SaaS, storefront, portfolio, and dashboard.

    Browse All Themes ➔