Fernline UI kit
Calm by default. Loud when it matters.
Tokens, components and patterns for AI agent operations products. Every piece works in light and dark, at AA contrast, and is built from the same two brand colors.
Foundations
Color scales
Generated in OKLCH from #00804C and #DBE64C. Lime is a fill with dark text, never text on light surfaces.
Green · primary (600)
Lime · accent (300)
Logo
Foundations
Semantic tokens
Components only use these. Dark mode is its own set of values, not an inversion. Run npm run contrast to verify every pair.
Surfaces
--bg--surface--surface-raised--surface-sunken--surface-hover--border--border-strongText
--text--text-muted--text-subtleBrand
--primary--primary-hover--primary-fg--primary-soft--accent--accent-hover--accent-fg--accent-softStatus
--success--success-soft--warning--warning-soft--danger--danger-soft--info--info-softCharts
--chart-1--chart-2--chart-3--chart-4--chart-5--chart-6--chart-7--chart-mono-1--chart-mono-2--chart-mono-3Surfaces
--bg--surface--surface-raised--surface-sunken--surface-hover--border--border-strongText
--text--text-muted--text-subtleBrand
--primary--primary-hover--primary-fg--primary-soft--accent--accent-hover--accent-fg--accent-softStatus
--success--success-soft--warning--warning-soft--danger--danger-soft--info--info-softCharts
--chart-1--chart-2--chart-3--chart-4--chart-5--chart-6--chart-7--chart-mono-1--chart-mono-2--chart-mono-3Foundations
Typography
Geist for UI and headlines, Geist Mono for data, IDs and labels. Sentence case everywhere; a lime scribble marks the one phrase that matters.
Foundations
Spacing & radius
A 4px grid. 8px radius for controls, 12px for cards, full pills for badges.
Spacing scale
4px8px12px16px24px32px48px64pxRadius
4px
6px
8px · controls
12px · cards
16px
pills
Foundations
Shadows
Very soft and green-tinted in light mode. The console prefers borders; shadows are for things that float.
xssmmdlgxlxssmmdlgxlFoundations
Gradients & grain
Layered CSS gradients with an SVG feTurbulence grain. No image files. Use sparingly: hero, banners, final CTA, recommended plan, upgrade card, empty states.
<GradientSurface variant="meadow" /><GradientSurface variant="pine-stripes" /><GradientSurface variant="aurora" />Components
Form controls
8px radius, strong border, green focus ring. Invalid fields say why in text, never color alone.
Enter a valid email.
Enter a valid email.
Components
Badges & status
Components
Cards & KPI tiles
Runs
86
1.1% vs 87 the day before
Success rate
96.6%
2.5% vs previous period
p95 duration
1m 43s
70% vs previous period
Pending approvals
25
Panel
Header, optional actions, body
Panels group one idea: a chart, a list, a form section.
Budget gauge
Month to date
$74.00
of $260.00 · forecast $273.00
Runs
86
1.1% vs 87 the day before
Success rate
96.6%
2.5% vs previous period
p95 duration
1m 43s
70% vs previous period
Pending approvals
25
Panel
Header, optional actions, body
Panels group one idea: a chart, a list, a form section.
Budget gauge
Month to date
$74.00
of $260.00 · forecast $273.00
Components
Data table
TanStack Table v9: sorting, selection, pagination and expandable rows, keyboard reachable.
| Support Triage | active | 16 | 96.0% | $0.076 | |
| Refund Assistant | active | 15 | 91.7% | $0.292 | |
| SDR Outreach | degraded | 12 | 82.1% | $0.175 | |
| Research Assistant | active | 9 | 93.2% | $1.431 | |
| Procurement Agent | paused | 0 | 83.3% | $0.020 |
Components
Charts
Recharts, colored by CSS variables so they switch themes with no JavaScript. Red is reserved for failures.
- Succeeded
- Needed approval
- Failed
- Spend
-
--chart-1Primary green: main series -
--chart-2Lime: accent / approvals -
--chart-3Teal: secondary series -
--chart-4Amber: warnings, forecasts -
--chart-5Slate: baselines, budgets -
--chart-6Red: failures only
- Succeeded
- Needed approval
- Failed
- Spend
-
--chart-1Primary green: main series -
--chart-2Lime: accent / approvals -
--chart-3Teal: secondary series -
--chart-4Amber: warnings, forecasts -
--chart-5Slate: baselines, budgets -
--chart-6Red: failures only
Components
Dialogs, sheets, menus and toasts
Components
Command palette
⌘K in the console: navigation, agents, and actions like “Approve all low-risk”. Nested pages for Pause agent… and Open run….
Patterns
Trace waterfall & span inspector
Nested, collapsible spans color-coded by type. ↑↓ moves, ←→ folds, Enter selects. Long approval waits are clipped so the agent's own work stays readable.
Timeline clipped: the run has been waiting on a human for 19m 51s.
LLM call
Plan
spn_7h2k9x01- Model
- claude-sonnet-5.5
- Latency
- 2.2s
- Started
- +290ms
- Tokens in
- 12,883
- Tokens out
- 563
- Cost
- $0.0471
- Look up the order for #8812.
- Check the refund policy.
- If eligible, refund and email the customer.
Patterns
Approval card
The human-in-the-loop moment: agent, action, risk, the arguments, the agent's reasoning, and a live SLA.
Refund Assistant
Policy: Refunds over $250
Issue refund $420 to customer #8812
issue_refund({"payment_id":"pi_8812x4010", "amount":420, "currency":"usd", "reason":"damaged_item", "customer":"#8812"})“The order arrived damaged 6 days ago and the customer attached a photo. Policy §2.1 allows a full refund within 30 days, so I want to refund $420 to the original card.”
Refund Assistant
Policy: Refunds over $250
Issue refund $420 to customer #8812
issue_refund({"payment_id":"pi_8812x4010", "amount":420, "currency":"usd", "reason":"damaged_item", "customer":"#8812"})“The order arrived damaged 6 days ago and the customer attached a photo. Policy §2.1 allows a full refund within 30 days, so I want to refund $420 to the original card.”
Patterns
Empty, loading, error and permission states
Every data view has all four. In the console, append ?state=empty|loading|error|denied or use ⌘K → Preview state.
Inbox zero
Every request has a decision.
Couldn't load this
The request timed out. Your data is safe; try again.
req_8f2a91 · 504 gateway timeout
You don't have access to this
Viewing this needs the Approver role. Ask a workspace admin, or request access below.
Your role: Viewer
Patterns
Code & JSON
Syntax colors are tokens too, tuned per theme.
from fernline import trace
@trace(agent="refund-assistant")
def handle(ticket):
return decide_refund(ticket) # 2 lines{ "payment_id": "pi_8812x4010", "amount": 420, "currency": "usd", "approved": true, "approver": null}from fernline import trace
@trace(agent="refund-assistant")
def handle(ticket):
return decide_refund(ticket) # 2 lines{ "payment_id": "pi_8812x4010", "amount": 420, "currency": "usd", "approved": true, "approver": null}