Documentation
Everything you need to build with the template
26 pages covering installation, the design system, content collections, authentication, data, SEO, security, testing and one page per deploy target.
Getting started
Introduction
What the template is, what ships in the box, and the principles that shape it.
Installation
Prerequisites, first run and the rename checklist for a new project.
Project structure
A tour of the repository layout and what belongs where.
Configuration
The three places you configure the template - site config, Astro config and environment variables.
Guides
Styling and dark mode
Tailwind CSS 4, the OKLCH design tokens, self-hosted fonts and the flash-free theme switch.
Content collections
How the docs, blog, authors, legal pages and changelog are modelled, authored and rendered.
Authentication
Better Auth with email and password, GitHub, Google and magic links, verification, password reset, account self-service and how routes are protected.
Database
Drizzle ORM with libSQL, the local file database, Turso in production and the migration workflow.
Actions and forms
Type-safe form handling with Astro Actions, validation, honeypots and the contact form example.
Admin area
The built-in administration pages for contact messages, users and the audit log, and how authorization works.
Privacy and data
What personal data the template stores, the self-service export and deletion flows, retention, and the checklist for adapting the legal pages.
SEO and discoverability
Metadata, Open Graph images, structured data, sitemap, RSS, robots.txt, llms.txt and search.
Security
The Content Security Policy, response headers, CSRF protection, production checks and secrets handling that ship enabled.
Testing
Unit and component tests with Vitest, end-to-end tests with Playwright, accessibility checks with axe and Lighthouse budgets.
CI and releases
The GitHub Actions workflows, the build matrix for every deploy target, Dependabot, Changesets releases and production database migrations.
Environment variables
Every variable the template reads, where to set it on each platform, and the two access patterns.
Deploy
Choosing a target
How the deploy switch works, what each platform supports and how to pick one.
Deploy to Vercel
Zero-configuration deployment to Vercel with Node 24 functions, static headers and image optimisation.
Deploy to Cloudflare
Running on Cloudflare Workers with static assets, workerd for on-demand routes and Node compatibility for Better Auth.
Deploy to Netlify
Netlify Functions for on-demand routes, the Image CDN for images and static headers for prerendered pages.
Deploy to Node and Docker
The standalone Node server, the multi-stage Dockerfile and notes for VPS and container platforms.
Reference
Site configuration
Every field in src/site.config.ts and what it controls.
Scripts
Every pnpm script in package.json, grouped by purpose.
Changelog process
How releases are recorded with Changesets and rendered on the site.
FAQ
Answers to common questions about the template.
Roadmap
What is planned for the template and how to propose changes.