rasheed@bustamam · ~/colophon
· ·

Colophon.

How this site is made — the honest accounting of tools, type, and decisions.

§ framework

Built with Astro. Content is authored in Markdown and MDX. No client-side framework — just HTML with a handful of small vanilla scripts for the theme toggle, search filter, and reading progress bar.

§ styling

Tailwind CSS v4 via the Vite plugin for utility classes. Most of the layout and component styling is written as scoped CSS or inline styles to keep specificity predictable.

§ typography

Serif: Newsreader (variable) — used for headlines and body prose.
Mono: JetBrains Mono (variable) — used for UI labels, metadata, and code.
Sans: Geist (variable) — reserved for occasional UI elements.
All fonts served from @fontsource — no Google Fonts requests.

§ design

Two themes — light and dark — are driven by a .dark class on the root element, toggled without JavaScript flicker via an inline script that reads localStorage before paint. Accent color is a deep red. Type scale is fluid using clamp().

§ hosting

Hosted on a Hetzner VPS. On push to main, GitHub Actions builds a Docker image and pushes it to the GitHub Container Registry. Caddy handles TLS and reverse proxies to the running container.

§ ai tooling

Built with Claude Code — design, implementation, and QA. Powered by Obra Superpowers for structured AI workflows, gstack for headless browser QA and site auditing, and Claude Design for visual design review and UI iteration.

§ feeds

Full-content RSS feed and JSON Feed are available. Both include the complete post body, not summaries.