Skip to content

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)

50100200300400500600700800900950

Lime · accent (300)

50100200300400500600700800900950

Logo

light
FernlineFernline
dark
FernlineFernline

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.

light

Surfaces

--bg
--surface
--surface-raised
--surface-sunken
--surface-hover
--border
--border-strong

Text

--text
--text-muted
--text-subtle

Brand

--primary
--primary-hover
--primary-fg
--primary-soft
--accent
--accent-hover
--accent-fg
--accent-soft

Status

--success
--success-soft
--warning
--warning-soft
--danger
--danger-soft
--info
--info-soft

Charts

--chart-1
--chart-2
--chart-3
--chart-4
--chart-5
--chart-6
--chart-7
--chart-mono-1
--chart-mono-2
--chart-mono-3
primary / primary-fgaccent / accent-fgsuccesswarningdangerinfo
dark

Surfaces

--bg
--surface
--surface-raised
--surface-sunken
--surface-hover
--border
--border-strong

Text

--text
--text-muted
--text-subtle

Brand

--primary
--primary-hover
--primary-fg
--primary-soft
--accent
--accent-hover
--accent-fg
--accent-soft

Status

--success
--success-soft
--warning
--warning-soft
--danger
--danger-soft
--info
--info-soft

Charts

--chart-1
--chart-2
--chart-3
--chart-4
--chart-5
--chart-6
--chart-7
--chart-mono-1
--chart-mono-2
--chart-mono-3
primary / primary-fgaccent / accent-fgsuccesswarningdangerinfo

Foundations

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.

Display XLEvery risky action, approved.
Display LA finished run is not a successful run.
HeadingApprovals
TitleIssue refund $420 to customer #8812
BodyPolicies pause a run before a risky tool call and the right person decides.
SmallRequested 07:08 UTC · SLA 2h
EyebrowAgent operations
Monorun_7h2k9xq4 · $0.0731

Foundations

Spacing & radius

A 4px grid. 8px radius for controls, 12px for cards, full pills for badges.

Spacing scale

4px
8px
12px
16px
24px
32px
48px
64px

Radius

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.

light
xs
sm
md
lg
xl
dark
xs
sm
md
lg
xl

Foundations

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" />
Light hero backgrounds, soft feature cards. Deep low-glow version in dark mode.
<GradientSurface variant="pine-stripes" />
Dark CTA banners, recommended pricing card. Dark in both themes.
<GradientSurface variant="aurora" />
Final CTA, announcements, hero product backdrop. Dark in both themes.

Components

Buttons

light
dark

Components

Form controls

8px radius, strong border, green focus ring. Invalid fields say why in text, never color alone.

light

Enter a valid email.

Soft limit40%
dark

Enter a valid email.

Soft limit40%

Components

Badges & status

light
NeutralPrimaryNewSuccessWarningDangerInfoOutlineSolid
SuccessFailedRunningAwaiting approvalCancelled
ActiveDegradedPausedLow riskMedium riskHigh riskCriticalVerified⌘K
dark
NeutralPrimaryNewSuccessWarningDangerInfoOutlineSolid
SuccessFailedRunningAwaiting approvalCancelled
ActiveDegradedPausedLow riskMedium riskHigh riskCriticalVerified⌘K

Components

Cards & KPI tiles

light

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

5 past SLA

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

dark

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

5 past SLA

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 Triageactive1696.0%$0.076
Refund Assistantactive1591.7%$0.292
SDR Outreachdegraded1282.1%$0.175
Research Assistantactive993.2%$1.431
Procurement Agentpaused083.3%$0.020

Components

Charts

Recharts, colored by CSS variables so they switch themes with no JavaScript. Red is reserved for failures.

light
  • Succeeded
  • Needed approval
  • Failed
  • Spend
  • --chart-1 Primary green: main series
  • --chart-2 Lime: accent / approvals
  • --chart-3 Teal: secondary series
  • --chart-4 Amber: warnings, forecasts
  • --chart-5 Slate: baselines, budgets
  • --chart-6 Red: failures only
dark
  • Succeeded
  • Needed approval
  • Failed
  • Spend
  • --chart-1 Primary green: main series
  • --chart-2 Lime: accent / approvals
  • --chart-3 Teal: secondary series
  • --chart-4 Amber: warnings, forecasts
  • --chart-5 Slate: baselines, budgets
  • --chart-6 Red: 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….

esc

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.

AgentLLM callTool callRetrievalHuman approval
Span
0ms3.5s7.1s11s14s
Refund Assistantwaiting
20m 2s waiting$0.0731
Plan
2.2s$0.0471
lookup_order
2.5s
refund-policy.md
1.3s
Decide refund
4.0s$0.0836
Human approval: Refunds over $250waiting
19m 51s waiting

Timeline clipped: the run has been waiting on a human for 19m 51s.

LLM call

Plan

OKspn_7h2k9x01
Model
claude-sonnet-5.5
Latency
2.2s
Started
+290ms
Tokens in
12,883
Tokens out
563
Cost
$0.0471
  1. Look up the order for #8812.
  2. Check the refund policy.
  3. 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.

light

Refund Assistant

Policy: Refunds over $250

High risk

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.”

1h 40m left
dark

Refund Assistant

Policy: Refunds over $250

High risk

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.”

1h 40m left

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.

runs
approvals
agents
alerts
evals
search
waiting
error
lock

Inbox zero

Every request has a decision.

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.

light
agent.py
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}
dark
agent.py
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}