Skip to main content
Component library
·v0.15.0

Library

Every component, state, and pattern in the system. Composed against Apple HIG, Material, Polaris, and Atlassian — then tuned to Lumen's restraint.

01 · Map

What's in here

A flat catalog. Each section labels variants by their canonical names so consumers can search the page for anything.

02 · Frame

Layout & structure

Page, Section, Header, Footer, Sidebar, Drawer, Modal container, Panel, Sheet, Toolbar, App bar, Divider, Spacer, Layout grid, Stack, Tabs panel.

Application shell
Top app bar, sidebar, main content region, right rail.
Acme Logistics
Saved views
Layout primitives
Stack (vertical)
Stack (horizontal)
Layout grid
Divider · horizontal

Vertical divider
Spacer (12 / 16 / 24)
Container variants
Fluid · fixed · max-width · two-pane · three-pane.
Fluid container
Fixed (max 720)
Two-pane (master-detail)
Three-pane
Sticky elements
Sticky header
Sticky action bar
04 · Action

Buttons & actions

Primary, Secondary, Tertiary, Ghost, Danger, Icon button, FAB, Link button, Split button, CTA, Toolbar actions, Bulk actions.

Intent
Primary
Secondary
Tertiary
Ghost
Danger
Loading
Disabled
Sizes
xs
sm
md
lg
Icon button (xs/sm/md/lg)
Split button & link button
Toolbar / contextual actions / bulk actions
Toolbar
42 rows
Bulk action bar
7 selected
05 · Inputs

Inputs · forms

Text · Textarea · Search · Number · Password · OTP · Tags · Combobox · Select. Field primitive bundling label, hint, error, leading, trailing.

Text inputs

32-character max

⌘K

⌘K opens command palette

Markdown supported

pallets
Strong

At least 8 characters with mixed case

Specialty inputs
TXCADry van

Press Enter or comma to add

#00FA8A
$1,200$2,400

Filter by lane price

72

Confidence threshold

Form group · validation
Carrier contact

For dispatch coordination only — never used for marketing.

Validation messages
Looks goodOptional fieldWill be visible to carriersEmail already in use
06 · Selection

Selection controls

Checkbox · Radio · Toggle · Switch · Segmented · Combobox · Select.

Checkbox · Radio · Switch
Checkbox
Radio group
Toggle / switch
Auto-quote enabled
Email digests
Disabled
Segmented · Select · Combobox
Segmented control
Select (dropdown)
Combobox (autocomplete)
07 · Pickers

Date · Time · Calendar

Date picker, time picker, calendar (month / week / agenda).

Date · Time picker
Date input
Time input
:
Calendar (popover)
May 2026
MoTuWeThFrSaSu
08 · Uploads

File · image upload

Drop zone · file preview · validation · progress.

Upload progress
bol-2026-04-29.pdf100%
rate-confirmation.pdf62%
invoice-3442.xlsx28%
09 · Display

Data display

Card · List · Tag/Chip · Badge · Avatar · Tooltip · Popover · Accordion · Carousel · Timeline · Tree view · Empty state.

Card variants
Flat card
Default elevation
Lifted card
Hover-active surfaces
Popover card
Floating affordances
Badge · Tag · Status pill
DefaultLivePendingFailedCarrierPremiumBetaWatchDisputedActivePendingFailedQueued
Avatar · presence · group overflow
AMAvery MercerJKJordan KimKMKai MorganLLLara LeeMMMaria Mendez
AMAvery MercerJKJordan KimKMKai MorganLLLara Lee+2
Severity · Trend · Confidence
LowMediumHighCritical
Tooltip · Popover
About this rate

Spot rates refresh every 90 seconds and reflect the live market on a confidence-weighted basis.

Accordion

Carrier picks weight contracted rates, historical reliability, and current capacity. The model is documented in the trust center.

List · Tree view · Timeline
SLSterling LTL
Sterling LTLTX → CA · 1d transit
$1,840
SMSaia Motor
Saia MotorTX → CA · 1d transit
$1,932
EEEstes Express
Estes ExpressTX → CA · 2d transit
$2,104
AFABF Freight
ABF FreightTX → CA · 2d transit
$2,221
design-system
00-foundations
principles.md
voice-and-tone.md
01-tokens
primitives
semantic
02-components
button
card
stat
audit-dashboard
src/app
src/components
  1. Quote sent
    Lumen AI · 10:42 AM
  2. Customer requested rate
    Sterling LTL · 10:38 AM
  3. Lane created
    Avery M. · 10:31 AM
  4. Carrier scorecard updated
    System · Yesterday
Carousel · Image frame
Spot rate compression
Q1 vs Q2 trend
New carrier scorecard
Weighted by SLA
Multi-stop quoting v2
Beta
Audit-ready receipts
PDF export
Empty state
No quotes yet

When a carrier responds to your request for rate, it'll show up here. Most quotes arrive within 6 minutes.

No data for this view

Adjust your date range or remove a filter to see results.

Key/value · Description list
Order ID
QT-3442-A
Customer
Sterling LTL
Origin
Dallas, TX 75201
Destination
Long Beach, CA 90802
Equipment
Dry van · 53'
Quote
$1,840.00
Status
Live
Skeletons (variants)
Card skeleton
Avatar skeleton
Form skeleton
10 · Tables

Tables · data grids · kanban

Data table with toolbar, filters, sort, density, sticky columns. Kanban for workflows.

Data table
Filter bar · column header · sort indicator · row hover · numerics tabular
4 rows
LaneCarrierRate $ΔStatus
TX → CA-014Sterling LTL1,840.00Live
OH → FL-022Saia1,420.00Pending
WA → NY-009Estes Express3,210.00Won
AZ → IL-031ABF Freight2,104.00Lost
Kanban board
To do4
Audit Sterling LTL contract
Due Mon
Configure spot rate alerts
Estes Express
QA dashboard release v1.4
Eng
Negotiate fuel surcharge
Old Dominion
In progress3
Lane TX→CA spot quote
Quote 3,442
Carrier onboarding — Saia
Jordan
Driver vetting — 6 carriers
Compliance
In review2
Rate update for ABF Freight
Pricing
Q2 carrier scorecard
Ops
Done5
Multi-stop quoting v2
Shipped
Saia integration
Live
11 · Viz

Charts · graphs

Line · Area · Bar · Stacked bar · Donut · Pie · Heatmap · Scatter · Radar · Treemap · Funnel · Histogram · Waterfall · Bullet · Cohort · Sparkline.

Time-series
Line chart
W1W2W3W4W5W6W7W8W9
Area chart
JanFebMarAprMayJunJulAugSepOct
Distribution
Bar (vertical)
MoTuWeThFrSaSu
Bar (horizontal)
Sterling LTL820Saia642Estes514ABF380OD290
Histogram
Stacked bar (segments)
Q1
84
Q2
90
Q3
98
Composition
Donut chart
$2.1BGMV
  • Sterling LTL38%
  • Saia22%
  • Estes18%
  • ABF12%
  • Others10%
Pie chart
  • Won64%
  • Lost22%
  • Pending14%
Treemap
Sterling LTL
38%
Saia
22%
Estes Express
18%
ABF
12%
Others
10%
Radar
SpeedCostSLACapacityRiskCoverage
Performance
Funnel
Lanes posted
100%
Quoted
62%
Accepted
62%
Booked
66%
Delivered
94%
Bullet (vs target)
Quotes
84/100
Pickups
72/80
OTD
94/90
Waterfall
Start+ New− Churn+ Expand− ReactivateEnd
Scatter
Heatmap · Cohort · Sparkline
Heatmap (activity)
MonWedFriSun
Booking activity · last 20 weeks
Cohort retention
CohortM0M1M2M3M4M5
Jan948467575035
Feb9782675950
Mar91817362
Apr958170
May10083
Jun92
Sparkline (inline)
Volume+34%
Gauge
72%
Capacity
94%
OTD
48%
Risk
12 · Metric

KPI · metrics

Stat block · KPI card · trend indicator · sparkline · goal progress · meter.

KPI cards
Quotes today 12.4%
2,104
vs 1,872 yesterday
Win rate 1.1%
64.2%
Avg lane $ 0.8%
$1,842
Capacity 4.4%
84%
across 12,400 carriers
Stat block (existing primitive) · LiveDot · RateTicker
Open quotes
42
+4.2%
Live rate
1.62$/mi
−0.3%
OTD
94.2%
+0.6%
Live ingest Lagging Stalled
Progress
Bar
Ring
72%
Stacked tracks
Quote acceptance72%
Onboarding48%
API errors12%
13 · Feedback

Feedback · status

Alert · banner · toast · snackbar · inline validation · system status.

Inline alerts
Page-level banners
Carrier compliance docs expire next week for ABF Freight.
You're viewing in sandbox mode — these quotes are not bookable.
A migration is running. Quoting is paused until 14:00 UTC.
Your usage is on track for the month — 22% under budget.
Toast · Snackbar
Saved
Quote drafted.
Update available
A new build is ready.
Failed to save
The carrier API timed out. Retrying in 8s.
Quote moved to drafts
14 · Overlay

Modals · drawers · popovers

Modal · type-to-confirm · drawer/sheet · popover · cookie consent.

Modals (rendered as cards)
Drawer · Popover · Cookie banner
Filters
Why is this rate higher?

Saia raised their fuel surcharge by 11% on Wednesday. The base rate is unchanged.

We use cookies

Essential cookies keep this site working. Optional cookies help us understand how it's used.

16 · Commerce

E-commerce primitives

Pricing · payment buttons · cart drawer · product gallery · selectors · checkout progress · feature comparison · inventory.

Pricing
MonthlyYearly −2 mo
Starter
For solo brokers.
$0/mo
  • Up to 50 quotes / month
  • Live carrier rates
  • Email support
Most popular
Growth
For growing teams.
$990/mo
  • Unlimited quotes
  • Multi-stop quoting
  • API access
  • 8-hour support SLA
Scale
For multi-region operations.
Custom/contract
  • Everything in Growth
  • Dedicated CSM
  • 99.95% uptime SLA
  • SOC 2 audit assistance
Feature comparison table
FeatureStarterGrowthScale
Live carrier rates
Multi-stop quoting
API access
Dedicated account manager
SLA · 99.95% uptime
SOC 2 audit assistance
Payment buttons
Product detail
Product image 1
Aero Co.

Aero Trail Runner v2

4.6(1,284 reviews)
$168.00$220.00−24%
Low stock — 3 left
Color: Charcoal
Cart · Order summary · Checkout progress
Your bag (3)
Aero Trail Runner v2
Granite · 10.5
1
$168.00
Heather Wool Tee
Pebble · M
2
$128.00
Trail Sock — 3 Pack
Charcoal
1
$24.00
Subtotal$320.00
Shipping calculated at checkout
  1. Cart
  2. Information
  3. Shipping
  4. Payment
  5. Confirm
Order summary
Subtotal$256.00
Shipping$8.50
Tax (8.875%)$23.49
Discount · WELCOME12−$30.72

Total$257.27
Inventory states
In stockLow stock — 3 leftBackorder · ships in 2 weeksPreorder · arrives May 19Sold out
17 · Auth

Auth · account · settings

Login · signup · social login row · MFA · session expired · workspace switcher · settings panels.

Login screen
warp.
Sign in

Use your work email to continue.

or
New to Warp? Request access
Workspace switcher · API key table
Workspace switcher (popover)
Workspaces
API key table
lk
Production · defaultlk_live_••••••••pX5F · created Apr 12
Active
lk
Production · backuplk_live_••••••••aJ2H · created Mar 31
Idle
tk
Sandboxlk_test_••••••••wQ9k · created Mar 14
Sandbox
18 · AI

AI · chat · copilot

Prompt input · suggestion · confidence · citation · thinking · shimmer · chat bubbles · composer · copilot panel.

Prompt + suggestion + citation
Lumen AI · Lane Suggestion
⌘⏎
Lumen suggestion
Reroute via Albuquerque to save $284

Saia carries this lane at $0.18/mi vs current $0.24/mi. Adds 38 mi but stays inside SLA. Sterling LTL has 4 active loads on the new path so capacity is reliable.

1
Sterling LTL contract — Section 4.2

All multi-stop shipments under 12,000 lbs are billed at base rate plus $42 per additional stop.

AI thinking · loading · badge
Thinking
AI generated
Loading shimmer
Chat surface
Chat thread (you · them · AI)
DS
Why is the quote for Sterling LTL higher than last week?
10:38 AM
Their fuel surcharge moved from 31% to 42% on April 26. Base rate hasn't changed.
10:38 AM
Can you draft a counter at 36%?
10:39 AM
Lumen AI is typing
Copilot side panel
Lumen Copilot
DS
Why is our spot rate exposure up this week?
10:42 AM
Three lanes shifted to spot pricing because the contracted carrier (Saia) hit capacity. $842 estimated impact this week.
10:42 AM
1
Sterling LTL contract — Section 4.2

All multi-stop shipments under 12,000 lbs are billed at base rate plus $42 per additional stop.

DS
Suggest a fix that doesn't break SLA.
10:43 AM
Thinking
Comment thread
AM
Avery Mercer14 min ago

Can we get a sanity check on the @sterling-ltl numbers? Their fuel surcharge looks 11% high.

2 replies
JK
Jordan Kim3 min ago

Pulled the underlying — they re-baselined yesterday. Numbers check out.

Reaction bar · presence
AMAvery MercerJKJordan KimKMKai MorganLLLara Lee
19 · Notify

Notifications · activity

Notification center · inbox item · grouping · preferences.

Inbox 3
New rate accepted
Sterling LTL accepted your $1,840 quote on Lane TX→CA-014.
2 min ago
Saia capacity dropped 18% this week
Six pending quotes on Saia routes need re-evaluation.
14 min ago
Driver vetting completed for Estes Express
1 h ago
Carrier scorecard exported to Slack
Yesterday
Notification preferences
Email · daily digest
Email · instant on rate accepted
Slack · Sterling LTL channel
Push · iOS
Push · marketing
20 · Editor

Editor · code · keyboard

Code block · markdown editor · keyboard shortcuts.

Code block
typescript
import { Stat, LiveDot } from "@lumen/react";

export function Hero() {
  return (
    <Stat label="Lane TX→CA" value="$1,842" trend={{ delta: 1.2 }}>
      <LiveDot />
    </Stat>
  );
}
Keyboard shortcut sheet
Open command paletteK
New quoteN
Find a laneL
Toggle themeT
Send quote
Close modalesc
21 · State

State matrix

Default · Hover · Focus · Active · Pressed · Selected · Disabled · Loading · Error · Success · Empty · Read-only · Dragging.

Button states
Default
Hover (simulated)
Pressed (simulated)
Focus
Loading
Disabled
Input states
Default
Filled
Focus
Error
Disabled
Status indicators (every tone)
DefaultActiveSuccessWarningErrorInfopendingqueuedprocessingcompletedcancelledfailedretry
22 · Templates

Page templates

404 · 403 · 500 · Maintenance · Error recovery · Login · Onboarding.

404
Page not found

The link's expired or never existed. Search the workspace or head home.

403
Access denied

You don't have permission to view this resource. Ask an admin to share access.

500
Server error

Something on our side broke. We've been notified — try again in a few seconds.

Scheduled maintenance

We're rolling out a database migration. Quoting is paused until 14:00 UTC. Existing shipments continue to track normally.

StatusPartial degradation
23 · Trust

Trust · compliance · environment

Trust badges · environment badges · sandbox/test mode banners.

Trust badges
SOC 2 Type IIISO 27001GDPR-readyHIPAA-eligiblePCI DSS
Environment badges
ProductionSandboxStagingLocalBetaAlphaExperimentalDeprecated
System banners
Sandbox mode — quotes cannot be booked.
You're impersonating Acme Logistics as an admin.
Idle timeout in 1 minute — confirm to stay signed in.
24 · Marketing

Marketing · landing

Hero · trust row · feature grid · stat strip · testimonial · pricing · footer.

Warp · Lumen design system

The instrument panel for North-American freight.

Live carrier rates, automated quoting, and operational signal in one calm surface. Built for the people who actually move trucks.

Sterling LTLSaiaEstes ExpressABF FreightOld Dominion
12,400
carriers indexed
$2.1B
freight under management
94%
quote accuracy
3.2 min
avg quote time
Live carrier rates

12,000 carriers indexed, refreshed every 90 s.

Automated quoting

From email to bookable quote in under 6 minutes.

Operational signal

Confidence scores on every recommendation.

Calm interfaces

Built for sustained, eight-hour use.

API-first

Everything in the UI is also a typed endpoint.

SOC 2 + ISO 27001

Compliance posture documented in the trust center.

"Lumen replaced four spreadsheets and three Slack threads. We can see the day."
JR
Jamie Rivera
Director of Logistics, Sterling LTL
25 · Spec

Spec · anatomy · handoff

The handoff layer: anatomy diagrams, redline specs, token references.

Component anatomy
Buttonprimary action
Token reference
json
{
  "color": {
    "accent":   "#00FA8A",
    "fg":       "var(--text-primary)",
    "bg":       "var(--surface-page)",
    "muted":    "var(--text-tertiary)"
  },
  "radius":  { "sm": 5, "md": 7, "lg": 10, "xl": 14 },
  "shadow": {
    "sm":  "0 1px 2px rgba(0,0,0,.06), 0 1px 1px rgba(0,0,0,.04)",
    "md":  "0 1px 2px rgba(0,0,0,.06), 0 4px 12px -2px rgba(0,0,0,.08)"
  },
  "motion": { "fast": "140ms", "base": "180ms" }
}
End of library — last refreshed v0.15.0