Skip to content

Configuration

File Purpose
astro.config.mjs site URL, sidebar, theme tokens, component overrides, social links
src/content.config.ts content collection schema (frontmatter validation)
src/styles/custom.css brand tokens and small style adjustments
wrangler.jsonc Worker name, static assets directory, 404 handling
public/_redirects permanent redirects for moved or retired URLs
public/_headers caching and security headers
.github/workflows/ci.yml pull request checks and preview deploy
.github/workflows/deploy.yml production deploy from main
.nvmrc Node version used locally and in CI

Autogenerated from the directory tree:

sidebar: [
{ label: 'Getting started', autogenerate: { directory: 'getting-started' } },
{ label: 'Guides', autogenerate: { directory: 'guides' } },
{ label: 'Reference', autogenerate: { directory: 'reference' } },
{ label: 'v1 (archived)', collapsed: true, autogenerate: { directory: 'v1' } },
],

Order within a group comes from sidebar.order in frontmatter, then alphabetical. To pin a group’s order, list its items explicitly instead of using autogenerate.