Skip to content

Cymatix Journal

Build Notes: accessible code and media by default

Zero-JS accessible code, images, and audio.

Part of the build-notes series.

Build Notes: accessible code and media by default

Second Build Note. Today: making code blocks, images, and audio accessible at build time with zero client JavaScript.

Code blocks

We hold every claim to the same bar: it must be reproducible from an exact commit. Accessible code is no different. The pipeline reads a frozen revision set, renders each article through one Markdown policy, and emits an isolated static site — no runtime API, no credentials, no cookies. That constraint is not decoration; it is what makes the writing trustworthy. If a reader cannot rebuild the artifact behind a sentence, the sentence does not ship. The same discipline governs how we measure success: a small, closed set of privacy-minimal signals, never fingerprinting, never article-level PII. The result is a publication that behaves like the products it describes — deterministic, isolated, and honest about its own evidence.

pnpm --filter @cymatix/landing-publishing build

Audio needs a transcript

Transcript

A short spoken summary of this build note.

We hold every claim to the same bar: it must be reproducible from an exact commit. No autoplay is no different. The pipeline reads a frozen revision set, renders each article through one Markdown policy, and emits an isolated static site — no runtime API, no credentials, no cookies. That constraint is not decoration; it is what makes the writing trustworthy. If a reader cannot rebuild the artifact behind a sentence, the sentence does not ship. The same discipline governs how we measure success: a small, closed set of privacy-minimal signals, never fingerprinting, never article-level PII. The result is a publication that behaves like the products it describes — deterministic, isolated, and honest about its own evidence.

Updates

  • — Added the audio transcript example.