# Stedefast

> A static site generator with a "static by design, dynamic by exception" philosophy. Generates fully static sites deployable to Cloudflare Pages, with dynamic modules that pre-generate static JSON files and only call Cloudflare Workers for user-triggered mutations — keeping server-side logic minimal.

Stedefast is an open-source TypeScript SSG for developers who deploy to Cloudflare. Templates are React (SSR) or Liquid. Dynamic features — comments, claps, newsletter, analytics, contact forms — are opt-in modules that each export pre-built JSON at build time and expose Cloudflare Pages Function handlers only for writes. The output is a fully static `dist/` folder that runs on any CDN with zero server processes in the hot path.

## Getting started

- [Quick start](/docs/getting-started/quick-start): Install and scaffold a new site in under a minute
- [Configuration](/docs/getting-started/configuration): Full `stedefast.config.ts` reference
- [How it works](/docs/getting-started/how-it-works): The 7-stage build pipeline explained

## Core concepts

- [Content graph](/docs/content/content-graph): How Markdown files are parsed, validated with Zod, and indexed
- [Templates](/docs/templates/overview): React SSR and Liquid templates, layouts, partials, islands
- [Module system](/docs/modules/overview): The `StedefastModule` interface — the central contract for dynamic features

## Modules

- [Comments](/docs/modules/comments): User comments stored in Cloudflare D1
- [Claps](/docs/modules/claps): Clap/like reactions via Cloudflare KV
- [Newsletter](/docs/modules/newsletter): Double opt-in newsletter; sends via Cloudflare Workers native `send_email` binding or Resend
- [Analytics](/docs/modules/analytics): Privacy-first page view tracking, no cookies
- [Contact](/docs/modules/contact): Contact form with Cloudflare Turnstile spam protection

## Deployment

- [Cloudflare Pages](/docs/deployment/cloudflare): One-command deploy with `stedefast deploy`
- [Email](/docs/deployment/email): Native Cloudflare Workers `send_email` binding (or Resend)
- [D1 migrations](/docs/deployment/d1): How module migrations are applied at deploy time

## Reference

- [CLI](/docs/cli/overview): `stedefast build`, `dev`, `deploy`, `init`, `scaffold`
- [Plugins](/docs/plugins/overview): Shiki syntax highlighting, Mermaid diagrams, OG images, reading progress
- [Admin panel](/docs/modules/admin): BetterAuth-powered admin SPA for managing module data
- [Provider system](/docs/deployment/providers): Swap Cloudflare bindings for Node.js adapters in dev/test