Skip to content
Astro Cloudflare

Project Structure

.
├── public/
│   ├── _headers             # Cloudflare Pages headers (security/CSP)
│   └── favicon.svg
├── functions/
│   └── api/cleanup.ts       # Optional R2 media cleanup worker (secret-guarded)
├── src/
│   ├── components/          # Reusable Astro components (Hero, CTA, FAQ…)
│   ├── content/             # Content collections (blog, docs, pages, services)
│   ├── i18n/                # Internationalisation utilities (routes, switcher, UI)
│   ├── layouts/             # Base layout with SEO, analytics, navigation
│   ├── lib/                 # Shared libraries (analytics, images, SEO, site config)
│   ├── pages/               # Astro pages with locale routing (+ llms.txt, robots.txt, rss)
│   ├── styles/              # Global CSS and Tailwind layers
│   └── content.config.ts    # Content collection schemas
├── .github/workflows/       # CI/CD workflows
├── astro.config.ts          # Astro + Starlight + integrations config
├── wrangler.jsonc           # Cloudflare Pages config (R2 binding)
└── package.json

Key Patterns

Section titled “Key Patterns”
  • Locale routing: default-locale routes live at the root; add src/pages/[locale]/ routes when introducing more languages.
  • Content collections: Markdown files in src/content/ with a locale frontmatter field (English by default).
  • Content editing: pure Git/Markdown — edit files and open a pull request.