Let's build USWDS docs sites together
Red Glare is an Astro integration for building federal documentation sites with real USWDS chrome, Comark-powered content, and build-time link validation — so every page ships production-ready.
-
USWDS out of the box
Government banner, header, sidenav, footer, identifier, breadcrumbs, and 404 — all real USWDS markup. No reimplemented chrome.
-
Markdown-first authoring
CommonMark via Comark, with MDC directives for alerts, accordions, code groups, tabs, process lists, summary boxes, and REST endpoint reference blocks.
-
Link validation at build time
Broken internal links fail the build — not production. Cross-references stay honest as content evolves.
-
Search, RSS, llms.txt
Pagefind search, RSS feed, sitemap, and llms.txt + raw-markdown endpoints for AI accessibility. One flag each.
-
Themed with USWDS tokens
Override USWDS Sass tokens to customize colors, fonts, and spacing. Variable fonts preloaded; zero runtime theming cost.
-
Static output anywhere
Builds to plain `dist/` — deploy to Cloudflare Workers, Netlify, Vercel, GitHub Pages, S3, or anywhere that serves HTML.