About this site

This is an Astro 6 + Starlight site that pulls notes from https://api.galaxy.example.com/api/v1/notes via Astro 6's live content collections.

Stack

Layer	Choice	Why
Framework	Astro 6	Live content collections, zero JS by default, SSR-friendly
Theme	Starlight ≥ 0.30	Built-in sidebar / TOC / Pagefind / i18n / RTL
Styles	Tailwind 4	CSS-first tokens via @theme, fast iteration
HTTP	axios	Retry-with-jitter + RFC 9457 error parsing
Adapter	@astrojs/node (standalone)	Single binary, easy to put behind Caddy

Caching

Live content collection responses ship with Cache-Control: public, s-maxage=60, stale-while-revalidate=86400. Cloudflare / Caddy honor these so the upstream Galaxy API is hit roughly once per minute per cache shard. Notes get cache tags like note:<slug> so we can purge precisely on edit.

Auth

The site holds a single bearer token (the galaxy-docs-site OAuth client) with scopes notes:read businesses:read tags:read. The token never reaches the browser — every fetch happens in SSR. End-user auth is not needed because every note exposed here is either org-wide or available to the token's business scope.