Foundations

Colour, type, spacing, elevation, surfaces, materials and device sizes, with the composers that tune them.

Colors
Which colours to use, how much and where. Two neutrals carry every surface, one primary accent anchors the brand, and a small set of semantic and decorative colours covers the rest. Tokens and modes are under Surfaces.

Brand colors and usage ratio

Ink, Sapphire and Pink in a 60 / 30 / 10 ratio, shared by product, marketing and docs.

60%
30%
10%
Ink tints #0C0E2E at 10%

Surfaces, text, borders

Sapphire #405CCF

CTAs, links, focus, data

Pink #F7C2FF

Signature accent

Semantic

Success --success oklch(63% 0.16 155) #00A35D
Danger --danger oklch(66% 0.18 24) #EC5B59
Warn --warn oklch(78% 0.17 67) #FF9E00
Info --info oklch(71% 0.15 269) #7C9BFD

Semantic state tokens

Each semantic state has three tokens in one hue, for alerts, callouts, toasts and info panels. Use --{name}-bg for the surface, --{name}-border for an optional border and --{name}-fg for emphasis text and icons. Both modes are set in :root and [data-theme="light"].

Success. The bridge route was found and quoted.

Info. This preset stays put across brand-preset switches.

Warn. The rate limit will reset in 30 seconds.

Danger. The transaction was rejected by the wallet.

Background Border Foreground
Success
--success-bg --success at 14%
--success-border --success at 30%
--success-fg --success at 100%
Info
--info-bg --info at 14%
--info-border --info at 30%
--info-fg --info at 100%
Warn
--warn-bg --warn at 14%
--warn-border --warn at 30%
--warn-fg --warn at 100%
Danger
--danger-bg --danger at 14%
--danger-border --danger at 30%
--danger-fg --danger at 100%

Text & icon colors --text-* · --icon-*

Grey tokens for text hierarchy and icon-only chrome. Icon tokens alias text tokens and can be overridden per theme.

Six tokens set every grey in the system. Use --text-* for prose, labels and numerals, and --icon-* for icon-only chrome. Both switch with the data-theme attribute on <html>.

Text

Theme-aware
Primary text
var(--text-primary) Headlines, hero numbers, primary body
100% ink. Black in light mode, white in dark.
Theme-aware
Secondary text
var(--text-secondary) Sub-headlines, supporting copy
75% ink. Section descriptions and supporting paragraphs.
Theme-aware
Muted text
var(--text-muted) Descriptions, captions, eyebrows
55% ink. Meta labels, value units, eyebrows and hints.
Theme-aware
Faint text
var(--text-faint) Chrome · axis ticks · placeholder hints
40% ink. Below WCAG body-text contrast, so only for axis labels, watermarks and similar.

Icon

Aliased
Primary icon
var(--icon-primary) = var(--text-primary) .btn-icon.btn-borderless
Rest colour for borderless icon buttons and any icon that matches its label. Aliases --text-primary.
Aliased
Muted icon
var(--icon-muted) = var(--text-muted) .btn-icon.btn-borderless.btn-muted
For an icon that yields to the row's content, such as a secondary toolbar action. Aliases --text-muted.

Extended palette --spectral-1 … --spectral-12

Twelve hues for charts, illustrations and decorative blocks. They do not change with the theme preset.

Twelve hues about 30° apart in OKLCH, balanced for categorical data. Hover a swatch for a note on its use.

Coral
--spectral-1 oklch(0.72 0.20 20) #FF8C7A
Orange
--spectral-2 oklch(0.74 0.20 50) #FF9358
Amber
--spectral-3 oklch(0.82 0.18 80) #FFB454
Lime
--spectral-4 oklch(0.84 0.20 110) #C5E866
Green
--spectral-5 oklch(0.78 0.22 140) #5EEAA0
Teal
--spectral-6 oklch(0.76 0.18 175) #3DD9D9
Cyan
--spectral-7 oklch(0.78 0.18 205) #42E2F5
Sky
--spectral-8 oklch(0.74 0.20 235) #67BAFF
Blue
--spectral-9 oklch(0.70 0.22 265) #7B86FF
Violet
--spectral-10 oklch(0.66 0.22 295) #9B5DE5
Magenta
--spectral-11 oklch(0.72 0.24 325) #D472FA
Pink
--spectral-12 oklch(0.76 0.22 355) #FF8FCB

Chart subsets

Neighbouring series should be far apart on the wheel. --series-1…--series-8 run blue, orange, green, magenta, amber, cyan, violet, coral.

4 series
6 series
8 series

The swatches above are documented at Components → Swatch.

Device resolutions & breakpoints
The laptop, tablet and phone sizes we design for, drawn to one scale. Layout uses the logical viewport (CSS px); native resolution and DPR are the hardware behind it. 1280 px (MacBook Air 13") is the design floor for laptop and wider, and the width the Advanced Limit widget fits.
Target layout width 1280 px
xl 7 / 16 devices are at least this wide — click any frame to set the width

Laptops & desktops

QHD display2560 × 1440
FHD display1920 × 1080
MacBook Pro 16"1728 × 1117
MacBook Pro 14"1512 × 982
MacBook Air 15"1496 × 967
MacBook Air 13.6"1470 × 956
MacBook Air 13" (M1)1280 × 800 · floor

Tablets

iPad Pro 11"834 × 1194
iPad 10.9"820 × 1180

Phones

iPhone 16 Pro Max440 × 956
iPhone Plus · Pro Max430 × 932
Pixel 8412 × 915
iPhone 16393 × 852
iPhone 12–15390 × 844
iPhone SE375 × 667
Galaxy S360 × 800
Elevation
How surfaces lift off the page. --elev-1/2/3 shadows show depth, --alpha-* overlays show state, and cards, rows and panels use elevation instead of hard borders. Materials bundle these tokens; components use them directly when a whole Material is more than they need.

Elevation tiers --elev-1 · --elev-2 · --elev-3

Three shadow tiers for resting cards, hover and floating surfaces.

Rest
Resting card / settings row

Subtle drop + 1px white-rim highlight (dark) / gentle drop (light). The default tier for content surfaces.

Hover and sticky active
Hovered row / active route

Stronger drop + brighter rim. The momentary lift signals interactivity without changing fill color.

Floating
Modal / popover / dropdown

Deep drop + brightest rim. Reserved for surfaces that float over the page (modals, popovers, dropdowns).

Alpha state layers

Four overlays that show state on top of a surface fill.

Alpha scale. Lay these over a surface fill, never in place of it.

--alpha-subtle
Tracks, recessed bases
--alpha-dim
Inactive hovers
--alpha-raised
Active pills, raised tiles
--alpha-overlay
Active hover, top elevation

Text on alpha. The colour under an alpha layer varies, so text on it uses its own tokens.

Default
--on-alpha-default
Muted
--on-alpha-muted
Primary
--text-primary

Elevation over hard borders

Container surfaces lift with fill and shadow, not a hard border. The Paper material bundles this; the manual recipe is for work outside the Materials API.

A hard 1px border on a flat fill reads as a form control. A raised fill with --elev-1 and an optional 6% hairline reads as lifted off the page.

Don’t: hard border
Quote summary

3 routes · best price via Stargate · ~12s

Do: raised fill + elev-1
Quote summary

3 routes · best price via Stargate · ~12s

Materials
Named bundles of fill, border, shadow, backdrop blur and edge highlight: paper, glass, gradient and halo. Change one attribute to switch a card, tile or panel between them; the Material Composer tunes their values. Materials sit between Surfaces, whose tokens they reference, and the components that read --mat-*.

Overview

Materials system data-material

Components read --mat-*; data-material on the element picks the material.

The same markup four times; only data-material differs.

data-material
paper

Default. Opaque fill, soft drop, 1px hairline.

data-material
glass

Translucent + backdrop-blur. Floating panels and marketing tiles.

data-material
gradient

Brand fill (blue → pink). Hero KPIs, cover tiles.

data-material
halo

Accent wash + radial glow. Brand-identity tiles.

Card anatomy

A card's layers pulled apart, and which foundation owns each.

Catalog

Paper data-material="paper"

Opaque fill, soft drop shadow, 1px hairline. The default.

24h volume
$1.24B

Cross-chain settlement across 30+ networks

Routes
30+
chains

Glass data-material="glass"

Translucent fill, backdrop blur and a neutral drop shadow, from the Panel Surfaces tokens.

For FAB sub-panels, side rails and anything that floats over content. Built from --surface-panel-glass, --shadow-panel-glass and --backdrop-panel-glass.

Network
Polygon

Connected · block 52,830,491

Gas
28
gwei

Gradient data-material="gradient"

Brand gradient fill with white text, for hero KPIs and cover tiles.

The loudest material: --lifi-sapphire to --lifi-ink at 135°. Text turns white automatically.

Cross-chain TVL
$8.42B

Total value secured · 30+ chains

24h
+12.4%
growth

Halo data-material="halo"

A soft accent wash with a radial glow at top right, for brand-identity tiles.

3 % accent over --surface-card, plus a 12 % accent glow from the top right that fades out by 70 %. Quieter than gradient. Shown with three tints.

Default tint
LI.FI

--lifi-ink — the system default

Cross-chain
Stargate

Custom tint · --lifi-sapphire

Settlement
12s · final

Custom tint · --lifi-pink

Branded tile data-material="halo" + --tile-accent-* + .is-active

The .brand-card recipe on any tile: halo, a per-tile accent and an active glow.

Three tiles with their own accents. The middle one has .is-active.

Partner

Acme Wallet

Cross-chain swap embedded directly in the wallet's send sheet. 400k MAU.

Integration

Solana via Wormhole

Now live — native USDC, JUP, and BONK route through the LI.FI router.

Ecosystem

Ondo Finance

RWA settlement layer — tokenised treasuries on six chains, one quote.

Spacing
The 4 px grid. --space-* tokens set every padding, gap and radius; width tokens cap floating surfaces; the sizing ladder sets the sm / default / lg / xl tiers of multi-size components; and gap and radius rules cover cards and nesting.

Spacing system

--space-2 through --space-160, in multiples of 4 px apart from the 2 px hairline.

--space-22px
--space-44px
--space-88px
--space-1212px
--space-1616px
--space-2020px
--space-2424px
--space-2828px
--space-3232px
--space-3636px
--space-4040px
--space-4444px
--space-4848px
--space-5252px
--space-5656px
--space-6464px
--space-7272px
--space-8080px
--space-9696px
--space-120120px
--space-160160px

Surface widths --w-*

Seventeen max-widths for popovers, menus, modals and panels, 32 px apart.

--w-1224px
--w-2256px
--w-3288px
--w-4320px
--w-5352px
--w-6384px
--w-7416px
--w-8448px
--w-9480px
--w-10512px
--w-11544px
--w-12576px
--w-13608px
--w-14640px
--w-15672px
--w-16704px
--w-17736px

Sizing ladders

Each tier sets a height, label size, padding and radius together. Buttons are the reference (#btn-sizes).

sm · 32px · dense rails, tables, toolbars
default · 40px · forms, primary CTAs
lg · 48px · heroes, marketing CTAs
xl · 56px · banner and poster CTAs

Card gap ladder --gap-card-*

Five tiers for the gap between sibling cards. Inline gaps use --cluster-*; content rhythm uses --stack-*.

The tokens name a position on the ladder, not a use case, so a preset can remap all five at :root and every consumer follows.

--gap-card is an alias for --gap-card-md, for short inline overrides. Write -md in component CSS.

XS (4 px), reserved

SM (8 px), compact lists

MD (12 px), default

LG (16 px), grids

XL (24 px), marketing grids


Nested rhythm. To tighten a group of children without changing the container's gap, wrap them in a stack that sets its own --card-gap. The swap form keeps 16 px between header, stack and footer, while its .ui-form-stack runs at 8 px.

Outer 16 px (lg), inner 8 px (sm)

Canvas grid spacing --grid-gap-x / --grid-gap-y

Horizontal and vertical canvas spacing for the Portal and Playground, set per theme in the Composer's Spacing section.

--grid-gap-x (default 16) is the gutter between side-by-side cards; --grid-gap-y (default 24) is the space between stacked sections. Neither changes with light or dark mode.

The Portal and Playground rail composers edit them with Compact, Standard and Spacious presets plus Custom sliders. Card lists use the card-gap ladder instead.

Column gap (16 px)

Row gap (24 px)


Presets set both axes. Values that match no preset select Custom.

Compact (x 12, y 16)

Standard (x 16, y 24), default

Spacious (x 24, y 32)

Nested radius

For nested rounded elements, the outer radius equals the inner radius plus the padding between them.

Nested corners stay parallel only when outer radius = inner radius + padding. For a new nested element, use inner radius = outer radius − padding. Matching the two radii makes the gap pinch at the corner.

Don't — matched radii

outer = inner ignores the padding, so the corner gap pinches around the bend.

32px 12px 32px

Do — radius + padding

outer = inner + padding keeps a constant gap all the way around the bend.

32px 12px 20px

In real components

card · radius 32

Inner 32 px, matched to the frame: the gap pinches.

card · radius 20

Inner 20 px = 32 − 12: the curves stay parallel.

Surfaces --surface-*
The four fill colours, from recessed to card, in dark and light. [data-theme] on <html> switches them. Materials build on these fills (paper.bg = var(--surface-card)); shadow and state are under Elevation.

Each ladder shows its own theme's values, whatever theme the page is in.

Dark

--surface-sunk oklch(5% 0.012 268) · recessed
--surface-page oklch(8% 0.015 268) · canvas
--surface-raised oklch(16% 0.016 268) · .panel shell
--surface-card oklch(24% 0.018 268) · card / tile

Light

--surface-sunk oklch(91% 0 268) · recessed
--surface-page oklch(100% 0 268) · canvas
--surface-raised oklch(97% 0 268) · .panel shell
--surface-card pivots → --surface-page · lifts via shadow

Which token for which job

  • --surface-sunk: recessed wells and demo containers. The only tier below the page.
  • --surface-page: the <body> background that everything sits on.
  • --surface-raised: .panel shells, the playground rail, the swap widget shell, footer bands. One step lighter than the page.
  • --surface-card: cards, tiles, paper-material consumers, .ui-amount-card. The top tier in dark; in light it equals --surface-page (white) and lifts by shadow alone.
  • --glass-base: the translucent base for the Glass material, outside the solid ladder. See Materials → Glass.
Typography
Two font families, one size scale, and the weight and spacing rules for each. All text uses var(--font-sans) unless set to var(--font-mono).

Font families --font-sans · --font-mono

Geist for content and UI; Geist Mono for code, addresses, numbers and eyebrows.

Aa

--font-sans

Geist · 7 weights

Aa

--font-mono

Geist Mono · 4 weights

Geist weights

Ag
Light · 300
Rare; deck whisper text
Ag
Regular · 400
Body, prose, default text
Ag
Medium · 500
Form labels, hints
Ag
Semibold · 600
Button labels, card titles
Ag
Bold · 700 ★
h1/h2/h3, hero, display
Ag
Extra-bold · 800
Deck tier (poster→colossal)
Ag
Black · 900
Reserved; brand extreme

Geist Mono weights

Ag
Regular · 400
Code, OKLCH values, addresses
Ag
Medium · 500 ★
Token names, eyebrows
Ag
Semibold · 600
Tab nav, panel titles
Ag
Bold · 700
Mono heading anchor (rare)

★ Default weight. Geist 700 for headings, Geist Mono 500 for token labels and eyebrows. Use another weight only when the content calls for it, such as a 600 button or a 400 paragraph.

Jumper typography --font-jumper

Jumper uses Urbanist for sans. Scale, weights, tracking and Geist Mono are shared with LI.FI.

Aa

--font-jumper

Urbanist · 7 weights

Aa

--font-sans · LI.FI reference

Geist

Same scale, two voices

Move value across chains. Urbanist 700 · --text-h2
Move value across chains. Geist 700 · --text-h2

Urbanist weights

Ag
Light · 300
Lockup sub-product labels
Ag
Regular · 400
Body, prose, default text
Ag
Medium · 500
Form labels, hints
Ag
Semibold · 600
Button labels, card titles
Ag
Bold · 700 ★
h1/h2/h3, hero, display
Ag
Extra-bold · 800
Deck tier (poster→colossal)
Ag
Black · 900
Reserved; brand extreme

Urbanist takes Geist's weights role for role (700 headings, 400 body, 500/600 UI). Until the brands split, Jumper differs from LI.FI in three things only: the jumper-1 / jumper-2 theme presets, the --jumper-indigo / --jumper-purple logo tokens, and this font.

Font pairings

Five ways sans and mono combine.

Section header

// 03 — Foundations

Color tokens describe intent

Pages reference var(--accent-primary) and var(--surface-raised), never literal OKLCH.

Mono eyebrow, sans heading and body, mono code for token references.

KPI stat

Volume routed · Q1 2026
$1.24B

Mono label and value, so numbers align when stacked; sans delta chip.

Inline references

Quotes route through the 0xb1739…ee01 aggregator on Arbitrum, return cached responses for ~80ms via the quote-cache service, and emit a QuoteReady event with amountOut and gasEstimate.

Mono code marks the things that exist in code; sans says what they do.

Detail list

Recipient
0x742d35…f8e3
Amount
1,250.00 USDC
Network
Arbitrum
Tx hash
0xb1739…ee01

Sans terms; hex values in mono code. Amounts use tabular-nums so they align across rows.

Tab nav + content

Bridge volume across 28 chains

Routes are scored by execution time, slippage, and fee. The aggregator returns the lowest-cost path for every quote.

Sans tabs over sans content, with an accent underline on the active tab. The catalog's own card tabs use mono uppercase with the same underline.

Type scale

One size scale for product, marketing and docs, from 256 px deck type to 10 px micro.

Deck scale (256–112px) is for slide covers, single-word reveals and canvas-fill statements; web and product (80–10px) is everything else. Deck sizes use pixel --lh-* tokens; web display sizes use unitless line-heights so clamped type doesn't overlap.

--text-colossal · 256px / 800 · −5% · 0.94 lh
LI.FI
--text-keynote · 192px / 800 · −5% · 0.94 lh
Connect.
--text-statement · 144px / 800 · −4% · 0.94 lh
Bridges.
--text-poster · 112px / 800 · −4% · 0.96 lh
Liquidity.
--text-hero · 80px / 700
Hero numbers
--text-display · 56px / 700
Display headlines
--text-h1 · 48px / 700
H1 · Section title
--text-h2-lg · 36px / 700 · value-display tier
Value display · $2,113.50
--text-h2 · 32px / 700
H2 · Subsection
--text-h3 · 24px / 700
H3 · Card title
--text-body-xl · 20px
Body XL · oversized lede, hero intros
--text-body-lg · 18px
Body LG · intro paragraphs, xl button labels
--text-body · 16px
Body · standard reading copy
--text-sm · 14px
Small · captions, helpers, table cells
--text-caption · 12px
Caption · labels, hints, eyebrows
--text-micro · 10px
MICRO · 0 8 12 16 20 24 · TICKS, BADGES, SUPERSCRIPTS
Components
Material Composer .material-composer
Tunes each material's opacity, blur, tint, shadow and highlight, and repaints every consumer on the page as you drag. The modal adds saved variants and JSON export. Changes last for the session only and are never restored on reload.

Pick a material on the right and drag the sliders; the four surfaces wear the active material.

Material Composer

Card · paper Cross-chain swaps Tune opacity / shadow / highlight to retune every card on the page.
Tile · paper Stat tile Reads the same --mat-* tokens; repaints automatically.
Small · paper Setting row
Panel · paper FAB sub-panel Try the glass material to see the blur slider come alive.
Editing material
Components
Semantic states --success
--success, --danger, --warn and --info are calculated from --brand-anchor, each with its own lightness offset, chroma multiplier and fixed hue. Each theme can retune them per mode in the Theme Composer’s Semantic states section, for example when a brand colour washes a warning out to grey.

Each role is oklch(from var(--brand-anchor) calc(l + L_offset) calc(max(c, 0.12) * C_mult) H). The 0.12 chroma floor keeps a muted or grey brand from turning the states grey. Everything below reads the live tokens, so it repaints when you pick or edit a theme.

Success

Route confirmed

Stargate via Polygon → Arbitrum settled in 12s with 0.04 % slippage.

Live +12.4 %

Danger

Transaction reverted

Insufficient gas on destination chain. No funds were moved.

Failed −4.1 %

Warn

High slippage detected

This route shows 1.8 % price impact. Consider reducing trade size.

Slow Beta 3 left

Info

New route available

Stargate just added a USDC bridge between Base and Arbitrum.

Note v2 New
Composers
Theme Composer
Pick, create or edit a theme and every surface repaints live. A theme sets the palette (Primary, Secondary, Tertiary and Background seeds for each mode), corners, spacing, surface contrast, panel elevation, semantic states, charts, text tint and brand font. Changes last for the session and are never restored on reload. Built from .screen-header, .theme-card, .option-card and .seg plus the shared window.ThemeComposer editor.

The live Theme Composer. Edits repaint only this card and aren’t saved. Click a theme in the list to load it into the editor.

List view


Edit view

Every axis shows here; real mounts show a subset through features (see Anatomy).