Design System

One standard, applied everywhere.

The shared language behind every Ioma Labs page — surfaces and ink, the five-tier palette, the type system, spacing, and components. Built as plain tokens and CSS so the marketing site, internal docs, and product surfaces all read as one thing.

01 — Color

Cool, clinical paper.

A muted paper neutral rather than the default warm cream, near-black ink, one schematic blue, one annotation amber — and five tier colors that carry the architecture through every diagram on the site.

Surfaces & ink

Paper
--paper
#F5F6F1

Default page background.

Raised
--paper-raised
#FFFFFF

Cards and raised surfaces.

Sunken
--paper-sunken
#ECEEE6

Footer, wells, table heads.

Ink
--ink
#15191E

Primary text, dark bands.

Ink soft
--ink-soft
#51585F

Body & secondary copy.

Ink faint
--ink-faint
#8B9097

Captions, meta, labels.

Rule
--rule
#DCDED5

Hairlines & grid lines.

Rule strong
--rule-strong
#C5C8BC

Emphasised dividers.

Brand accents

Schematic blue
--accent
#2B3F8C

Primary accent. Links, eyebrows, active states.

Accent ink
--accent-ink
#1E2C63

Pressed / deep accent.

Accent soft
--accent-soft
#E6E9F4

Accent tint fills.

Annotation amber
--amber
#B9722A

Secondary accent. Status, flags.

Amber soft
--amber-soft
#F3E4CF

Placeholder-tag fills.

The five-tier palette

01 · Substrate
--tier-substrate
#A97D49

Retrieved knowledge substrate.

02 · Specialist
--tier-specialist
#5E7F73

Parallel specialist inference.

03 · Assembly
--tier-assembly
#5A6F99

Deterministic state assembly.

04 · Appraisal
--tier-appraisal
#8B6B8D

Metacognitive appraisal.

05 · Articulation
--tier-articulation
#2B3F8C

Trained articulatory model.

Tier colors are fixed: a stage is always the same hue wherever it appears — diagram, chip, dot, or the identity strip at the top of every page.

02 — Type

Three voices, clearly divided.

A structural display face for headings, a serif for body copy that gives the writing field-notes gravitas, and a monospace reserved strictly for labels, eyebrows, and data annotation.

Ag
Halogen
Display · headings

Falls back to Archivo until the licensed Halogen files are dropped in. Weights 700 / 800.

Ag
Source Serif 4
Body · long-form

Optical-sizing on. Regular, Medium, Semibold + italic.

Ag
IBM Plex Mono
Labels · data

Eyebrows, rail labels, tier chips, captions. Uppercase, tracked.

Type scale

Display 4XL--text-4xl
clamp 2.6–4.4rem
A mind, built like a brain.
Display 3XL--text-3xl
clamp 2.1–3rem
Five stages, one system.
Display 2XL--text-2xl
clamp 1.6–2.15rem
State assembly & appraisal
Lede LG--text-lg
1.15rem · soft ink
Each stage is modular and independently inspectable — closer to how a research team reviews a draft than how a single mind blurts out a first impression.
Body Base--text-base
1rem · 1.6 line
Specialist outputs are combined through a fixed, repeatable assembly procedure — the same inputs produce the same assembled state, every time. This is the seam in the pipeline we can most directly inspect.
Mono label XS--text-xs
0.75rem · tracked
01 — Architecture
03 — Spacing

An 8-pixel rhythm.

Spacing steps from an 8px base; corners stay nearly square; structure is drawn with hairlines, not shadows. Whitespace is generous and consistent across every page.

Spacing scale

--s-18px
--s-216px
--s-324px
--s-432px
--s-548px
--s-664px
--s-788px — section padding
--s-8120px

Rules & radius

Hairline

1px rules

Sections, cards, and tables are separated by 1px --rule lines. Grids show the rule color through 1px gaps.

Radius

4px, sparingly

Corners stay near-square (--radius: 4px). The drafting feel comes from straight edges, not rounding.

Container

1240px max

Content caps at --maxw with a 92px annotation rail on the left at desktop widths.

04 — Components

The shared parts.

Every page is assembled from this small, consistent kit. Hover to see the interaction states.

Buttons

Mono uppercase labels · 1px ink border · primary fills to accent blue on hover.

Tier chips & eyebrow

Research Stage 01 Self-checking Closed evaluation Placeholder

Cards

Stage 01

Retrieved knowledge substrate

A foundation layer the system can draw on rather than relying purely on weights — grounding output in something inspectable.

Stage 02

Parallel specialist inference

Narrower specialist processes run concurrently rather than one generalist doing everything at once.

Stage 03

Deterministic state assembly

Specialist outputs are combined through a fixed, repeatable procedure — not another opaque learned guess.

Callout

A system that can only generate, never review, will confidently say whatever its first pass produces. We want a system with an internal checkpoint.

— Ioma Labs, design philosophy

Comparison table

DimensionSingle-pass modelCalliope (prototype)
Reasoning traceabilityInternal — not directly inspectableInspectable at five tier boundaries
Self-correctionLimited — one passDedicated appraisal tier
GroundingVaries by promptingSubstrate consulted twice

Roadmap / timeline

  • Phase 2 — Complete

    End-to-end prototype built

    Calliope running as a full pipeline from substrate retrieval through articulation.

  • Phase 3 — In progress

    Benchmarking against frontier models

    Structured comparison across reasoning, grounding, and output quality.

05 — Schematic

The signature element.

A literal cross-section of the architecture — substrate at the base, parallel specialists, convergent assembly, an appraisal loop, articulation at the top. Numbered, because here the sequence is real, not decorative. Reused at different scales across the site.

Architecture motif — drawn at small scale

A standalone diagram motif — the same stack abstracted: substrate, specialists, accent at the apex. Used in figures, not beside the wordmark.

Full interactive schematic

Lives at hero scale on the home page — hover any stage to highlight it and read what it does.

One system, end to end.

See it applied across the live pages — or read the architecture this whole visual language is built around.