Pain001

Colophon

Made with ssg: How This Site Is Built

Markdown in, hardened static HTML out: the toolchain behind this site.

1 min readLast reviewed

This site is compiled by the Static Site Generator (ssg), written in Rust with a security-first default posture: WCAG validation, CSP metadata, SBOM generation, and AI-discovery files (llms.txt) built into the toolchain.

The full stack, for the curious:

  • Content: Markdown with structured frontmatter, versioned in Git.
  • Build: ssg compiles content and layouts into static HTML; a build script repairs, localises and checks the output, and CI publishes it to GitHub Pages.
  • No runtime: no JavaScript framework, no server, no database. The scripts are small and same-origin: theme and motion preferences, navigation, search, and a cookie-free page-view beacon. The one exception is the browser demo, which loads a WebAssembly Python runtime on request and runs the library locally.
  • Machine-readable surfaces: llms.txt, sitemap.xml, RSS, Atom, JSON Feed, security.txt, humans.txt, and a CycloneDX SBOM.

The same philosophy as the Pain001 software: standards first, validation as a gate, nothing hidden.