Tokens, primitives, fintech components and patterns for trustworthy AI. Each exists because of a principle in docs/ai/01-research-brief.md.
System
Light
Dark
Tokens
One violet hue is reserved for AI-originated content, so it is always recognisable and never confused with brand blue or status colours.
ai.accent
ai.subtle
ai.border
confidence.high
confidence.medium
confidence.low
AILabel
Always words plus an icon. The compact form says 'AI' but is still announced in full.
AI-generated
AI
Flagged automatically
Banner
Icon + words in every tone. The AI tone is not dismissible by default.
Ai notice
Short supporting text that explains what happened and what to do next.
Info notice
Short supporting text that explains what happened and what to do next.
Success notice
Short supporting text that explains what happened and what to do next.
Warning notice
Short supporting text that explains what happened and what to do next.
Danger notice
Short supporting text that explains what happened and what to do next.
Neutral notice
Short supporting text that explains what happened and what to do next.
Chip
Suggestions and choices. 36pt tall with a 48pt tap area.
Disclosure
ThinkingIndicator and StreamingText
Words always accompany the dots. With reduced motion the dots are still and text appears at once. Screen readers get the full text immediately, never character by character.
Working on it
MessageBubble
Assistant messages carry the AI label and are announced as 'Assistant said, AI-generated: …'.
What's my balance?
AI
Your Checking balance is $8,240.12.
ConfidenceIndicator
Three categories, shown as bars and words. Use it only where it can change a decision.
High confidence
Medium confidence
Low confidence
FeedbackControl
Helpful, or not. If not, it asks why.
Was this helpful?
MoneyRangeText
A forecast as a range with an 'Estimate' label, never a single number.
$1,180.00–$1,340.00
Estimate
$310.00–$520.00
Estimate
InsightCard
Labelled, explainable in two taps, correctable, controllable.
AI-generated
Dining is up 23% this month
$412.60
You've spent more on restaurants than your usual pattern.
High confidence
Was this helpful?
ActionProposalCard
AI proposes; a person disposes. Nothing moves until the customer confirms.
Drafted by AI
Review before sending
$50.00
To
Sam Rivera
From
Checking •••• 4821
When
Today
Nothing has been sent yet.
Drafted by AI
Review before sending
$2,500.00
To
Jordan Lee
From
Checking •••• 4821
When
Today
You haven't paid Jordan Lee before. Check the name carefully.
Nothing has been sent yet.
FraudAlertCard
Specific facts and reasons, equal weight to both answers, a person one tap away.
Is this you?
We noticed an unusual purchase on your card ending in 4 8 2 1.
Electro Mart
Oct 6, 2026 · Lisbon, Portugal
−$1,299.00
Flagged automatically
DataUseRow
What, why, on/off in words, and a way to erase it.
Spending insights
Looks at your transactions to spot patterns.
Used for: insights and forecasts
On
HumanHandoff
Always reachable. Honest about the wait, or silent if it's unknown.