Configuration covers every surface you use to customize a site built on this theme: site identity and metadata, menu structures, navigation behavior, and page layouts. These are the primary touchpoints for making the theme your own without modifying core framework code.
Who this is for
- Implementors — setting up a new site’s identity, menus, and page layouts through configuration files.
- Developers — understanding the configuration contracts so you can extend them or build tooling around them.
- AI agents — generating valid configuration that conforms to the typed schemas and passes validation.
Key concepts
- Site configuration — a single typed configuration file defines site identity (name, tagline, contact info), social links, and global metadata. The schema is Zod-validated at build time.
- Menu configuration — navigation menus are defined declaratively as data structures, not hardcoded into templates. Multiple menu zones (main nav, footer, utility) are supported.
- Navigation system — the theme provides header, footer, and mobile navigation components that consume menu configuration. Navigation behavior (sticky header, mobile breakpoints) is configurable.
- Layouts — page layouts control the structural shell around content. The layout system supports multiple layout variants selectable per-page through frontmatter.
In This Topic
- Content Management (CMS) — Enable and configure Sveltia CMS for git-based content editing through a browser-based admin interface.
- Infinite Loading — Load More progressive enhancement for article listings and docs indexes, with site-level configuration toggle.
- Layouts — Page layout components — BaseLayout, PageGridLayout, BlankLayout, PageGrid, and Container.
- Menu Configuration — Reference for the menu configuration contract — main navigation and utility navigation structure, customization pattern, and key design decisions.
- Navigation System — How the primary, utility, and mobile navigation systems work and how to configure them.
- Site Configuration — Reference for the site configuration contract — structure, customization pattern, and key sections in src/core/config/site.schema.ts.
- Site Feature Configuration — Feature toggle configuration — theme mode, theme-docs, article listing, analytics and consent, scroll-to-top, lightbox, and environment variables.
- Site Style Configuration — Typography and font overrides, fluid token configuration, and the core style override system — everything needed to rebrand the visual layer.
- View Transitions — Configuration and usage guide for Astro native view transitions — SPA-style navigation with cross-fade animations, per-page opt-out, reduced motion behavior, and animation directive extension points.