Design system

Style guide

Every specimen below is rendered with the real tokens and the real component classes. If it looks wrong here, it is wrong on the site.

Colour

Reach for the semantic aliases (--fg-1, --bg-1, --border-1) in component CSS where you can. Clay is a brand mark, never a navigation cue — links stay blue.

Surfaces

  • --paper
  • --paper-deep
  • --paper-pure
  • --hover-bg

Ink

  • --ink
  • --graphite
  • --pencil
  • --rule
  • --rule-soft

Accent

  • --clay
  • --clay-deep
  • --clay-soft

Link

  • --link
  • --link-hover
  • --visited

Status

  • --phosphor
  • --amber
  • --vermilion

Type

Families

  • --font-mono · JetBrains Mono Bespoke websites for interesting people 0123
  • --font-mono-2 · IBM Plex Mono Bespoke websites for interesting people 0123
  • --font-serif · Source Serif 4 Bespoke websites for interesting people 0123

Scale

  • --type-12
  • --type-13
  • --type-14
  • --type-16
  • --type-18
  • --type-20
  • --type-24
  • --type-32
  • --type-44
  • --type-64
  • --type-96

Headings

Headings are left-aligned, never centred, never all-caps. Specimens are marked decorative so the page keeps a sane heading outline.

  • h1

    Aa Bespoke websites

  • h2
  • h3
  • h4
  • h5
  • h6

Leading & tracking

  • --leading-tight I design & build bespoke WordPress sites from inception to execution. No page builders, no parent themes, no nonsense.
  • --leading-snug I design & build bespoke WordPress sites from inception to execution. No page builders, no parent themes, no nonsense.
  • --leading-normal I design & build bespoke WordPress sites from inception to execution. No page builders, no parent themes, no nonsense.
  • --leading-loose I design & build bespoke WordPress sites from inception to execution. No page builders, no parent themes, no nonsense.
  • --tracking-tight Bespoke websites
  • --tracking-normal Bespoke websites
  • --tracking-wide Bespoke websites

Inline elements

Body copy sits at --type-16 with --leading-loose. A link looks like this, a visited one shades purple, and inline code gets a hairline box. Strong and emphasis both hold their weight.

function bain_meta_bracket( $text, $args = array() ) {
	// Square brackets are added by CSS, never by the caller.
}

meta-bracket — brackets come from CSS

Sign-off ♥

Terminal cursor

Space

A 4px base grid. Corners are square everywhere — --radius is 0 and load-bearing.

  • --space-1
  • --space-2
  • --space-3
  • --space-4
  • --space-5
  • --space-6
  • --space-7
  • --space-8
  • --space-9
  • --space-10

Components

Buttons

Rendered by bain_button( $label, $url, $args ) — the only button that should be reached for. .bain-btn is always present; the variant is an additional modifier class, chosen with $args['variant']. Hover for the 2px hard-offset press shadow.

  • Fill dark (default)
    .bain-btn variant omitted, or 'primary'
    Arrange a chat now
  • Outline
    .bain-btn.bain-btn--ghost variant: 'ghost'
    Check out my work
  • Fill terracotta
    .bain-btn.bain-btn--terracotta variant: 'terracotta'
    Send a brief
  • External link modifier
    .bain-btn.bain-btn--ghost any variant + external: true — adds target="_blank", rel, and the ↗ arrow
    View on GitHub

Outline's hover shadow is clay, not ink — an ink shadow behind an ink-filled hover state has no visible edge, the same defect fixed on the dark related-project card on single project pages. Fill terracotta's text is ink rather than paper: clay against paper text measures 2.95:1, below WCAG AA's 4.5:1 for normal text; against ink it is 4.72:1.

Down from six independent implementations to two, both kept apart from .bain-btn on purpose rather than by omission — see each specimen's label. Both now carry the same :focus-visible ring .bain-btn has, which neither had before: a:focus-visible is set sitewide, but nothing covered plain <button> elements.

Buttons deliberately not built on .bain-btn

  • .tools-filter-pill archive-bd324_tools.php — a multi-select filter toggle with an is-active state, not a link; bain_button() only renders <a href>
  • .bain-project__stack-pill single-bd324_projects.php — a tag, not a button (no cursor: pointer); listed for contrast

Cards

Three tones — default (flush with the page), --surface (raised white panel), --ink (inverted) — plus optional parts: __title / __dot, __meta (add --link when it is an <a>), __desc, __cta. A card only uses the parts it needs; plain content works directly inside it too.

Promoted 2026-07-30 from .contact-channel-card, page-contact.php's dark/light card, which is where the ink tone's two fixes below came from and now apply to every ink-toned card, not just that one: .meta-bracket defaults to graphite, sized for a light card, which read as near-invisible on dark; and the generic a:focus-visible outline is ink, invisible against a card whose own background is ink. Before this, .bain-card had no real usage anywhere on the site outside this demo — .contact-channel-card was the only card with real structure, so its structure became the generic one rather than a second system being invented.

2026 / Frontend

Card

Hairline border that thickens to 2px on hover, with the padding compensating so the contents never reflow. Default tone: plain content works with no card parts at all.

utility

bain-press

Same card with the press-shadow utility applied.

Checked list

  • Every site is coded from scratch.
  • Wireframes, responsive layouts, bespoke themes & plugins.
  • Rendered by bain_check_list().

Rules

hr, then .bain-rule-double, then bain_ascii_rule().



Forms

Motion

One easing curve, --ease-1, and three durations. Hover a tile to run it.

  • --dur-1
  • --dur-2
  • --dur-3