03Color

Slate is the product. Color is the data.

Chrome is neutral. When color appears it marks a band, a status, or an evidence state, or it is the one brand accent, which is brand and never state. Semantic color is always paired with a label; never the only indicator.

Slate rail — canvas and raw fills

Slate 50 → 900
slate-50#f8fafc
Hover fill
slate-100#f1f5f9
Canvas · --eg-muted
slate-200#e2e8f0
StatCard border
slate-300#cbd5e1
Hover border
slate-400#94a3b8
Unknown status dot
slate-500#64748b
No fixed role
slate-600#475569
Pending · unknown text
slate-700#334155
No fixed role
slate-800#1e293b
No fixed role
slate-900#0f172a
No fixed role

Text and border tiers

Neutral oklch, not slate
fg-1oklch(0.145 0 0)
Titles · foreground
fg-2oklch(0.37 0 0)
Body
fg-3oklch(0.556 0 0)
Muted text
fg-4oklch(0.708 0 0)
Placeholder
borderoklch(0.922 0 0)
Border · input

Primary — near-black

Actions, focus anchor
--eg-primary
oklch(0.205 0 0)

Brand accent — Editorial Plum

--eg-accent · brand, never state
accent#602e63
Links · rules · dots
accent-soft7% on white
Eyebrow pill fill
accent-border28% on white
Pill border

The accent belongs to the brand and marketing surfaces (apps/www, apps/docs/brand) — eyebrow dots, editorial links, article rules, OG cards, illustration highlights. Authenticated product apps use foreground and muted tokens for links and nav, not plum. Never on band pills, primary buttons, or inside the mark; the focus ring stays neutral. Utilities: text-brand, bg-brand-soft, border-brand-border.

Match-band aliases

--eg-band-* · BandBadge renders bg · fg · border
Suggested match
Suggested match
Score 75 and up · meets most requirements
--eg-band-likely-bg · --eg-band-likely-fg
Possible match
Possible match
Score 50 to 74 · check the open points
--eg-band-uncertain-bg · --eg-band-uncertain-fg
Weak match
Weak match
Below 50 · misses key requirements
--eg-band-unlikely-bg · --eg-band-unlikely-fg

Band token reference

Full --eg-band-* family
Suggested match
--eg-band-likelydot--eg-band-likely-bgcard bg--eg-band-likely-bordercard border--eg-band-likely-fgcard fg--eg-band-likely-pill-bgunused--eg-band-likely-pill-fgtext accent
Possible match
--eg-band-uncertaindot--eg-band-uncertain-bgcard bg--eg-band-uncertain-bordercard border--eg-band-uncertain-fgcard fg--eg-band-uncertain-pill-bgunused--eg-band-uncertain-pill-fgtext accent
Weak match
--eg-band-unlikelydot--eg-band-unlikely-bgcard bg--eg-band-unlikely-bordercard border--eg-band-unlikely-fgcard fg--eg-band-unlikely-pill-bgunused--eg-band-unlikely-pill-fgtext accent

Status colors

--eg-status-* aliases · use these, not raw rails
Pending
Draft
--eg-status-pending-bg · --eg-status-pending-fg
Active
Uploading · analyzing · deleting
--eg-status-active-bg · --eg-status-active-fg
Complete
Analysis complete
--eg-status-complete-bg · --eg-status-complete-fg
Error
Analysis failed
--eg-status-error-bg · --eg-status-error-fg

Evidence states

Dashed shells on criterion evidence
Unknown
Criterion status unknown · the reviewer decides
amber-50/40 · amber-200/80 · dashed
Unverified evidence
Met or partial without a verified quote · no credit until a reviewer decides
violet-50/40 · violet-300/80 · dashed · dot violet-500

Abandoned directions

Do not reintroduce as brand or chrome
Violet as brand or chrome accent · retired
Indigo-600 · retired
04Type

One family. A deliberate scale. Tabular numbers everywhere that counts.

Geist Sans for UI, Geist Mono for tabular and code-ish content. Product screens use RouteShell titles and review headers from the H1 and body rows below, not the marketing hero clamp (reserved for apps/www).

The scale

Geist Sans
Hero (www only)
clamp 32 → 52px
Evalgist
H1
24px
Review results
Lede
17px
A shortlist backed by evidence, per qualification, per candidate.
Body
14px
Per candidate, per qualification. Evidence anchored to the source document.
Muted
14px
10 of 32 reviewed
Mono
13px
bg-primary text-primary-foreground
Caption
11px (text-2xs)
CRITERIA · NOTES · GIST

Eyebrow

.eg-eyebrow
Evalgist · Evaluation tools
Compliance

11px, semibold, uppercase, 0.15em tracking. Default color is fg-3; override with --eg-eyebrow-color for the rare dark variant, as shown above.

Tabular numbers

Stats, progress, counts
147
Resumes analyzed
12
Suggested match
30
Credits remaining
05Shape

Corners scale by role. Shadows stay light.

Shape is quiet; the point is content, not chrome. Resting surfaces carry a faint shadow, overlays lift further, and nothing glows.

Radii

--eg-radius family
sm
6px
menu and select items
md
8px
Button · Input · Badge · popover
lg
10px
Dialog · Alert · StatCard · dropzone
xl
14px
Card
full
9999px
pill · dot · balance

Shadows

--eg-shadow-* mapped in theme.css
shadow-xs
--eg-shadow-xs
outline Button · Input · EvidenceQuote card
shadow-sm
--eg-shadow-sm
Card · list cards (max elevation for lists)
shadow-md
--eg-shadow-md
menus and compact popovers when xs/sm is not enough
06Space

A 4-pixel grid. One shared content column.

Card padding is p-6 (24px). The RouteShell stack is gap-6. Canvas padding is px-4, px-6 from lg, and py-6. Page mode keeps RouteShell at its default max-w-6xl; evidence review uses the wide max-w-7xl column. Everything else falls out of the 4-pixel grid.

Spacing scale

Tailwind-aligned
1
0.25rem
4px
2
0.5rem
8px
3
0.75rem
12px
4
1rem
16px
5
1.25rem
20px
6
1.5rem
24px
8
2rem
32px
12
3rem
48px

Two surface modes

Pages vs. workspaces
Page mode

Dashboard, settings, credits, create flows, and setup wizards. RouteShell default width, max-w-6xl, on a px-4 lg:px-6 py-6 canvas. Card-based, page-level scrolling. Users pass through quickly.

Workspace mode

Candidate review. RouteShell width="wide" (max-w-7xl): a 380px candidate list beside a sticky detail panel. The page scrolls as one. Users spend time here.

07Icons

Lucide. Default stroke. Size follows the slot.

One icon set, stroke-based, at Lucide's default 2px stroke. Always paired with a label or used in a known slot. Sidebar rows use 18px, admin rows 16px, and dense review controls 16px.

Sidebar navigation

SidebarNavLink · 18 px
LayoutDashboard
Dashboard
PlusCircle
New shortlist
Coins
Credits
UserRound
Account (mobile sheet)

Admin navigation

SidebarNavLink dim · 16 px
BarChart2
Admin overview
Users
Admin users
Briefcase
Admin shortlists
CreditCard
Billing
AlertTriangle
Issues
MessageSquareWarning
Verdict reports
ScrollText
Audit log
Settings
Technical settings

Review and chrome

16 px in dense controls · Menu 20 px
FileText
Resume · document
ChevronLeft
Prev candidate
ChevronRight
Next candidate
Download
Export
AlertTriangle
Parse warning
Menu
Mobile nav · 20 px
31Motion

Durations by job. One named keyframe.

Consumer transitions use the durations below. Rotating UI uses the named keyframe.

Transition durations

Hover, panels, content swaps
hover · color
150ms · ease-out
buttons, links, rows
hover · shadow
150ms · ease-out
cards, stat-cards on hover-reveal
dialog · open / close
200ms · fade + zoom
Dialog, AlertDialog
sheet · open / close
500ms open · 300ms close · ease-in-out
Sheet
cross-fade · content swap
300ms · ease-out
auto-cycle detail panel (`animate-in fade-in-0 duration-300`)

Named keyframes

@keyframes shipped from tokens.css
eg-cycle-progress
scaleX(0) → scaleX(1)
AutoCycleProgressBar · transform-origin: left · driven by the consumer's `animationDuration`
3500ms · linear · forwards--eg-cycle-progress

Reduced motion

The contract on `prefers-reduced-motion: reduce`
  • AnimatedGridPattern has no breakpoint of its own. Call sites hide it below their breakpoint (www: lg). It does not yet respond to `prefers-reduced-motion`.
  • AutoCycleProgressBar and AutoCyclePauseToggle render nothing under reduced motion; the cycle does not advance.
  • No fade-in on page load. Use `animate-in fade-in-0` only on content swaps the user triggered.
  • No bounces, no springs, no chromatic ring transitions.
08Don'ts

Visual rules and common mistakes.

Visual rules come first. They match the table at the top of PATTERNS.md. The tiles below pair the wrong pattern with the right one.

Visual rules

PATTERNS.md · selected row · quotes · tokens

Selected list row

Wrong: a colored left bar, a left bar on a card, or a left bar on the active sidebar item.

Right: the neutral slate left bar only on the selected row in a list (`ReviewQueueItem`, Shortlist candidate list). Sidebar active stays font-medium and foreground.

Quoted evidence

Wrong: a left rule on the outer card, highlight bands pretending to be quote chrome, or a second quote style in the same flow.

Right: `EvidenceQuote`: bordered figure, blockquote with `border-l-2 border-foreground/15` inside the shell.

Surface fill

Wrong: a tinted background and a colored border on the same box.

Right: a background or a border, not both in competing colors.

Semantic color

Wrong: a green dot or amber strip with no label.

Right: color plus a label or icon (`Badge`, `BandBadge`, status dots).

Tokens

Wrong: text-[11px] or raw emerald-100 in new code.

Right: text-2xs, bg-verdict-*, and mapped shadows (shadow-xs, shadow-sm).

List elevation

Wrong: heavy shadows on dense list cards.

Right: shadow-sm at most on list surfaces.

Shipping

Wrong: a one-off composition because the screen is urgent.

Right: add the pattern to PATTERNS.md and the showcase, then import it.

Color on data only

Wrong: colored nav, tinted ordinary cards, colored borders, or text-brand in a product app.

Right: slate and semantic tokens for chrome. One exception: a featured upsell card, such as the recommended credit pack, may carry a sky tint.

Bands, not scores

Wrong: 87% on the review list, the candidate header, or a screening export.

Right: Suggested match on the list and header. The numeric breakdown sits in the analysis audit sheet, opened from the Criteria heading.

Active state: weight, not pill

Wrong: a pill background or a rounded highlight on the active sidebar item.

Right: font-medium and text-foreground on the sidebar. List selection uses the left bar rule above, not the sidebar pattern.

Empty states earn their keep

Wrong: a mascot, “Oops”, or an exclamation mark.

Right: two short sentences: what is here, and what to do next.