BHmanifesto · v0.1
Manifesto · design-system operating contract
Vol. 01 · Essay
01

Determinism, or nothing.

A short manifesto on building one typeface, one grid, one accent, one theme contract, and refusing to let the public surface drift into accidental decoration.

1. The argument for one of everything.

Most interfaces are accidents in shipping costume. They inherit a typeface they never chose, a color they cannot defend, and a spacing rhythm that changes whenever a new page gets urgent enough. The result may load. It does not cohere.

This system chooses constraint as an implementation detail, not a slogan. One monospace face. One ruled page grammar. One accent at a time. One theme switcher. One set of semantic variables that every surface reads before it paints anything.

Discipline is not the enemy of expression. It is the precondition for it.
Every additional choice is a maintenance contract. Sign fewer of them.

2. What the rules buy.

Rules buy speed because decisions are made once. They buy legibility because pages share a grammar. They buy trust because a user can move from essay to math engine to protocol page without relearning the interface.

  • One face: display, body, charts, code, labels, and controls share the same width logic.
  • One grid: cells and rules become coordinates, not decoration.
  • One accent: attention is scarce and must be assigned deliberately.
  • One theme contract: pages do not own color. Tokens do.
papersurface
inktext
accentsignal
tintpanel

3. The contract.

RuleImplementation demand
Theme firstEvery public page mounts the same color-scheme switcher and reads semantic variables from tokens.js.
Routes realNavigation links must resolve as built pages, not placeholders, hashes, or dead demos.
Controls visibleInteractive surfaces expose the controls a user expects: sliders, toggles, print actions, route links, and stateful theme choice.
Receipts requiredBuild, link, route, and responsive checks are part of the artifact.

4. What this rejects.

It rejects decorative drift. It rejects one-off colors hidden in page files. It rejects landing pages that explain a product instead of becoming the first usable surface. It rejects the idea that design quality lives outside the build and validation loop.

A public site is a living interface contract. If the contract is precise, new pages become faster and safer. If the contract is vague, every page becomes a negotiation. The manifesto is simple: do the negotiation once, encode the result, and hold the line.