Hellbox CI example

Proof your fonts on every commit. This repo renders a font proof PDF with Hellbox on a GitHub Actions runner, fails the build if character coverage or layout regresses, and attaches the proof as a build artifact.

• proofs/family.fontproof is a proof document authored in Hellbox (here via the CLI: hellbox --proof fonts/... --save-doc). It proofs Space Grotesk (SIL OFL), all four named instances, structured after Ohno Type Co's "Proof it!" essay: big character boards, a complete glyph grid with metric lines, HH/OO and nn/oo spacing strings, kerning text, original reading copy at 8/11/14/21pt, and a tracking test from 0 to +20.
• proofs/fonts/ holds the font binaries. Hellbox resolves fonts relative to the document, so the committed proof renders on any machine.
• .github/workflows/proof.yml installs the Hellbox app plus the hellbox pip package (pip install hellbox gives you the CLI anywhere the app is installed), runs hellbox render-check (machine-readable coverage + overflow audit), gates the build on it, then exports the PDF artifact.

Grab the rendered proof from any run's artifacts, or just open proofs/family.pdf: the workflow commits the freshly rendered PDF back to the repo on every main push, so the proof you see is always current.

1. Fork this repo (or copy the workflow).
2. Author a .fontproof in Hellbox for your typeface and commit it with your font binaries beside it (or have your CI font build place them there).
3. Push. Coverage regressions and layout overflows now fail the build.

Full guide: hellbox.com/docs/ci

Space Grotesk is included under the SIL Open Font License (see OFL.txt). The workflow and configuration are MIT.

Tip: the workflow pushes a "Render proof" commit after each run, so git pull --rebase before pushing from your machine.