Quick Start

The stack

Astro + Starlight + Tailwind CSS 4, driven entirely by bun. The build outputs pure static HTML/CSS/JS — no runtime, no database.

Run it locally

bun install     # install dependencies
bun run dev     # dev server with hot reload

Build the static site

bun run build   # outputs pure HTML/CSS/JS to dist/
bun run preview # serve the production build locally

Deploy

bun run deploy          # build + push to Cloudflare Pages (production)
bun run deploy:preview  # build + push to a preview branch

See Free Hosting and Cloudflare Pages CLI for the full deployment flow.

Project structure

security-docs/
├── astro.config.mjs          # Tailwind Vite plugin + Starlight config + sidebar
├── src/
│   ├── styles/global.css     # synthwave theme (tokens, Tailwind, neon components)
│   └── content/docs/         # markdown/MDX — one page per file
│       ├── getting-started/
│       ├── guides/
│       ├── deployment/
│       └── reference/
└── dist/                     # static build output