A system for evidence-first software.

Component pages mount the real primitives from @evalgist/design-system. Foundations values are documented against the tokens. Compositions are listed in the pattern catalog; atoms and doc-only specimens sit under Components, Shell, and Workflows.

02Principles

The system agrees on these before anything else.

Principle 01
Evidence, not verdicts

Every AI judgment is anchored to a literal quote or reference from the source. The product surfaces evidence so the human can show what each decision rests on to a candidate, a student, or an auditor.

Principle 02
Privacy is a claim with a receipt

External surfaces name concrete data handling: EU storage, no AI-provider retention, public service-provider lists, and deletion rules for extracted document text. Avoid “privacy by design” unless the page also shows what that means.

Principle 03
Monochrome chrome

Chrome is neutral: white bars and cards on a slate-100 canvas. Color is semantic and used only on data — match bands, criterion status, evidence states, progress segments. Decoration and navigation stay monochrome; product apps do not use brand accent on chrome.

Principle 04
Bands, not scores

On review surfaces, show match bands only — Suggested match, Possible match, or Weak match — not headline percentages. Numeric score, rank, and per-criterion confidence stay in the analysis audit sheet (opened from Criteria), not on the candidate list or header.

Principle 05
One family, one focus ring

Geist Sans for everything UI. Focus is a neutral 2px ring at 30% opacity, except destructive controls, which use a destructive tint. Radius scales by role: 14px for Card, 10px for mid-surfaces (Dialog, Alert), 8px for controls (Button, Input, Badge), 6px for inline items, 9999px for pills. Headlines and titles use text-balance; body copy and descriptions use text-pretty. Never let a single word strand on the last line.

Principle 06
Quiet motion

Short, mechanical, monochrome. 150–200ms transitions on hover. No bounces, no springs, no fade-ins on page load. Pulse animation is reserved for live state: the Analyzing status dot and the sticky action bar status dot.

Principle 07
Text is the hard floor

Ambient decoration declares the text region as an exclude zone, and nothing animates inside it. A feathered edge thins the decoration out before it reaches the copy, so there is no straight seam. On small screens the call site hides decoration entirely.

Areas

Overview plus four areas.

Start on this page, then follow Foundations, Components, Shell, and Workflows. Product flows maps Shortlist and Grade routes to catalog compositions. Open Pattern catalog for the full composition list; View demo jumps to the matching specimen with the same contract above it.

Color, type, shape, space, icons, motion, and what to avoid.
7 sections
Single primitives: controls, cards, states, tables, and content.
18 sections
Chrome, app shell, work surfaces, and page-level actions.
8 sections
Multi-step flows and evidence review layouts.
4 sections
Shortlist and Grade routes mapped to the compositions they import.
2 products
Compositions from PATTERNS.md with when-to-use rules and live demos.
39 compositions