.brand-lockup primitive; Jumper differs by its brand colour tokens and Urbanist label.Brand lockup .brand-lockup
On navigation surfaces, .brand-lockup--back swaps the mark for a back arrow on hover.
<!-- Navigation surface: an <a href> with .brand-lockup--back -->
<a href="/" class="brand-lockup brand-lockup--back" aria-label="Back to lifi.fi">
<span class="brand-lockup__glyph">
<svg class="brand-lockup__glyph-idle"><!-- LI.FI mark --></svg>
<svg class="brand-lockup__glyph-hover"><!-- back arrow --></svg>
</span>
<svg class="brand-lockup__wordmark"><!-- LI.FI letters --></svg>
<span class="brand-lockup__label">Playground</span>
</a>
| Property | Value | Token |
|---|---|---|
| Glyph + wordmark height | 24px | var(--space-24) |
| Mark canonical viewBox | 0 0 40 48 | logos/lifi/lifi-mark.svg; never narrower than 40 (the curves paint to x≈38.628) |
| Stacked canonical viewBox | 0 0 32 48 | logos/lifi/lifi-lockup-stacked.svg; compact mark redraw in currentColor |
| Lockup gap (glyph ↔ wordmark) | 4px | var(--space-4) |
| Wordmark ↔ label gap | 2px | var(--space-2) |
| Label font | Figtree | Inherits from html |
| Label size | 16px | var(--text-body) |
| Label baseline nudge | translateY(0.5px) | Optical correction; the Light label reads about 1px low against the wordmark |
| Label weight | 300 | Light |
| Label tracking | 0 | var(--tracking-normal) |
| Label colour | muted ink | var(--text-muted) |
| Hover swap duration | 180ms ease | — |
| Class | Role | Notes |
|---|---|---|
| .brand-lockup | Wrapper | <a> for a back link, <div> for static identity |
| .brand-lockup--back | Modifier: back link | Enables the back-arrow hover swap. Only on navigation surfaces such as the DS nav and product rails |
| .brand-lockup__glyph | Mark slot | 24×24 box; both glyph SVGs sit absolutely so the swap doesn't shift layout |
| .brand-lockup__glyph-idle | Idle SVG | LI.FI chevron mark; visible by default |
| .brand-lockup__glyph-hover | Hover SVG | Back arrow; fades in on hover only with .brand-lockup--back |
| .brand-lockup__wordmark | "LI.FI" letters | Always visible; never animates |
| .brand-lockup__label | Sub-product name | Optional. Hidden below 720px |
- One label per surface. Don't stack labels such as "Playground · Beta"; show status with a chip.
- Use
<a href>and.brand-lockup--backonly for a back link. Static identity, such as a footer, marketing hero or catalog preview, uses the bare.brand-lockup. - Inside a sub-product rail, drawer or sidebar, hide the host page's
.navbar-site__logowithdisplay: none, so the brand appears once per surface. - Never restyle the wordmark. No outlines, shadows, gradients or font swaps.
- The sub-product label is uppercase Figtree Light. Every LI.FI sub-product uses the same recipe; don't add per-product fonts or weights.
- The label hides below 720px. Don't add per-product media queries to override it.
CSS: styles.css, search .brand-lockup.
Consumers: playground.html (rail header), ds-nav.js (DS catalog navbar).
Tokens: var(--space-24), var(--space-4), var(--space-2), var(--text-body), var(--font-mono), var(--text-primary), var(--text-muted), var(--text-secondary).
Spec: design/components/imagery.md → ### Brand lockup
Jumper lockup .brand-lockup--jumper
Two-tone mark on --jumper-indigo and --jumper-purple, so it flips with the mode. The label is Urbanist.
<!-- Same slots as LI.FI; fills use the Jumper tokens, never hex -->
<a href="/" class="brand-lockup brand-lockup--jumper brand-lockup--back" aria-label="Back to jumper.xyz">
<span class="brand-lockup__glyph">
<svg class="brand-lockup__glyph-idle"><!-- Jumper mark · logos/jumper/jumper-mark.svg --></svg>
<svg class="brand-lockup__glyph-hover"><!-- back arrow --></svg>
</span>
<svg class="brand-lockup__wordmark" viewBox="29 0 89 25"><!-- JUMPER letters --></svg>
<span class="brand-lockup__label">Pass</span>
</a>
| Property | Value | Token |
|---|---|---|
| Glyph + wordmark height | 24px | var(--space-24) |
| Mark canonical viewBox | 0 0 24 25 | logos/jumper/jumper-mark.svg |
| Wordmark crop viewBox | 29 0 89 25 | Letters-only crop of jumper-lockup.svg, full height |
| Stacked canonical viewBox | 0 0 45 44 | logos/jumper/jumper-lockup-stacked.svg |
| Body + wordmark fill | #31007A light · #653CA2 dark | var(--jumper-indigo) |
| Accent-piece fill | #8700B8 light · #B49BDA dark | var(--jumper-purple) |
| Label font | Urbanist | var(--font-jumper) |
| Label colour | accent 2 · #8700B8 light · #B49BDA dark | var(--jumper-purple) |
| Label size / weight | 16px · 300 | var(--text-body) · var(--fw-light), as LI.FI |
| Label baseline nudge | translateY(-0.25px) | Optical; the JUMPER baseline sits at 18/25 of its box, LI.FI's at 36/48 |
| Gaps (glyph↔wordmark · wordmark↔label) | 4px · 2px | var(--space-4) · var(--space-2) |
| Class / asset | Role | Notes |
|---|---|---|
| .brand-lockup--jumper | Brand variant modifier | Composes onto .brand-lockup. Changes only the label: Urbanist, --jumper-purple, its own baseline nudge |
| .brand-lockup__glyph-idle | Jumper mark | Fills var(--jumper-indigo) / var(--jumper-purple), with light-mode hex fallbacks |
| .brand-lockup__wordmark | "JUMPER" letters | Paths, no font; about 85px wide at 24px high |
| .brand-lockup__label | Sub-product name | Pass, Scan or Learn; Urbanist in --jumper-purple, uppercase |
| logos/jumper/ | Canonical asset dir | jumper-mark.svg · jumper-lockup.svg · jumper-lockup-stacked.svg; every consumer copies from here |
- Tokens, never literals. Body and wordmark use
var(--jumper-indigo), the accent piecevar(--jumper-purple). Hex in a consumer freezes the logo in light mode; the asset files keep hex only asvar()fallbacks, for<img>and downloads. - Don't fork a Jumper lockup. Add
.brand-lockup--jumperto the shared primitive; it changes only the label. - JumperPass, JumperScan and JumperLearn are the JUMPER wordmark plus a label (Pass, Scan, Learn), as with LI.FI Playground. Don't set the compound name as one wordmark.
- Use
jumper-mark.svgfor the glyph alone andjumper-lockup-stacked.svgfor square slots. Never crop the horizontal lockup's viewBox by hand. - Never restyle the wordmark. No outlines, shadows, gradients or font swaps.
- The
jumper-1/jumper-2theme presets retheme surfaces; the logo tokens stay fixed. Don't wire the logo fills to--accent-*.
Assets: logos/jumper/jumper-mark.svg · logos/jumper/jumper-lockup.svg · logos/jumper/jumper-lockup-stacked.svg.
CSS: styles.css, search .brand-lockup--jumper and --jumper-indigo (dark in :root, light in [data-theme="light"]).
Export: shared.js → initBrandLockupExport(), per-brand geometry in the BRANDS map (data-lockup-brand="jumper").
Typography: var(--font-jumper) (Urbanist), see Foundations → Typography.
Theme presets: presets.js → jumper-1 / jumper-2.
Spec: design/components/imagery.md → ### Brand lockup
LI.FI logo
Clear space ½H, minimum sizes 16 / 20 / 48 px, one ink.
Pick the variant by slot shape: the mark for avatars, favicons and tight square slots; the horizontal lockup for headers, documents and co-branding; the stacked lockup for app tiles, social cards and tall square slots. H is the rendered logo height.
Clear space ½H
No text, icons, other logos or container edges inside the zone, measured from the logo's bounding box.
Mark · H 48 → clear space 24
Horizontal · H 32 → clear space 16
Stacked · H 96 → clear space 48
Colour
One ink, no accent colours: black on light surfaces, white on dark. In the product it uses currentColor and follows --text-primary.
On light, black
On dark, white
Minimum sizes
Below the floor, switch variants: a horizontal lockup under 20 px becomes the mark; a stacked lockup under 48 px becomes the mark or the horizontal lockup.
Mark · 16 px floor
Horizontal · 20 px floor
Stacked · 48 px floor
| Requirement | Value | Notes |
|---|---|---|
| Clear space | ½H · all four sides | H = rendered logo height, from the bounding box |
| Minimum size, mark | 16px tall | Smaller, the notch closes up |
| Minimum size, horizontal lockup | 20px tall | Letters render about 10px |
| Minimum size, stacked lockup | 48px tall | Letters render about 8.4px |
| Mark viewBox / aspect | 0 0 40 48 · 5:6 | lifi-mark.svg; never narrower than 40 (the curves paint to x≈38.628) |
| Horizontal viewBox / aspect | 0 0 132 48 · 11:4 | lifi-lockup.svg |
| Stacked viewBox / aspect | 0 0 32 48 · 2:3 | lifi-lockup-stacked.svg |
| Ink | single · black on light · white on dark | currentColor; in-product follows --text-primary |
- One ink. Black on light, white on dark,
--text-primaryin the product. No accent colours, gradients or two-tone. - Keep the ½H clear space. If a slot can't hold it, use a smaller variant instead of crowding.
- Use the files in
logos/lifi/. Don't crop a lockup down to the mark (use the mark file) and don't redraw it. - No transforms or effects. Don't stretch, skew, rotate, outline, shadow or glow. Scale uniformly.
- Never typeset the wordmark. The letters are paths; don't rebuild them in Figtree or any other font.
- On photography or busy surfaces, put the logo on a solid white or near-black plate sized to the clear-space zone.
Assets: logos/lifi/lifi-mark.svg · logos/lifi/lifi-lockup.svg · logos/lifi/lifi-lockup-stacked.svg, downloadable from the Brand Lockup card above.
In-product rendering: .brand-lockup (styles.css).
Spec: design/components/imagery.md → ### Brand lockup → Logo usage guidelines
Jumper logo
Clear space ½H, minimum sizes 16 / 20 / 48 px, a two-tone pair that flips by mode.
Clear space, minimum sizes and variant choice work as for LI.FI. The difference is colour: the Jumper logo is two-tone, and the pair flips with the mode.
Clear space ½H
Mark · H 48 → clear space 24
Horizontal · H 32 → clear space 16
Stacked · H 96 → clear space 48
Colour
The spark, the small top dash, is accent 2 (--jumper-purple); the body and wordmark are accent 1 (--jumper-indigo). The light pair goes on light surfaces, the dark pair on dark.
Light pair · Indigo #31007A · Vivid Purple #8700B8
Dark pair · Purple #653CA2 · Lavender #B49BDA
--jumper-purple
Body + wordmark · --jumper-indigo
Minimum sizes
Below the floor, switch to a smaller variant, as for LI.FI.
Mark · 16 px floor
Horizontal · 20 px floor
Stacked · 48 px floor
| Requirement | Value | Notes |
|---|---|---|
| Clear space | ½H · all four sides | H = rendered logo height, from the bounding box |
| Minimum size, mark | 16px tall | Smaller, the spark merges into the body |
| Minimum size, horizontal lockup | 20px tall | Letters render about 9.6px |
| Minimum size, stacked lockup | 48px tall | Letters render about 6.5px |
| Mark viewBox / aspect | 0 0 24 25 · ~1:1 | jumper-mark.svg |
| Horizontal viewBox / aspect | 0 0 118 25 · ~19:4 | jumper-lockup.svg |
| Stacked viewBox / aspect | 0 0 45 44 · ~1:1 | jumper-lockup-stacked.svg |
| Accent spark | #8700B8 light · #B49BDA dark | var(--jumper-purple) |
| Body + wordmark | #31007A light · #653CA2 dark | var(--jumper-indigo) |
- Keep both tones. Never swap them, and never flatten the logo to one colour without brand review.
- Never mix pairs across modes. A light indigo body with a dark lavender spark is a broken logo.
- Tokens in code. Use
var(--jumper-indigo)/var(--jumper-purple)so the mode flip is automatic. Hex lives only in the asset files, asvar()fallbacks for<img>and downloads. - Don't recolour to theme accents.
--accent-*retheme surfaces; the logo tokens stay fixed. - Keep the ½H clear space and the size floors.
- No transforms, effects or typeset wordmark. Scale uniformly; the JUMPER letters are paths, not Urbanist text.
- Use the files in
logos/jumper/; never crop the horizontal lockup by hand to get a mark.
Assets: logos/jumper/jumper-mark.svg · logos/jumper/jumper-lockup.svg · logos/jumper/jumper-lockup-stacked.svg, downloadable from the Brand Lockup card above.
Brand tokens: styles.css — --jumper-indigo / --jumper-purple (dark in :root, light in [data-theme="light"]).
In-product rendering: .brand-lockup--jumper (styles.css).
Spec: design/components/imagery.md → ### Brand lockup → Logo usage guidelines
scripts/iso/scripts/iso/*.mjs on a shared engine. Lines are white on ink and retint with the brand; animated scenes loop in place. For the motion showcase, see the brand guide's "in motion" cards.24 tiles · devices and emblems, composable objects, and scenes that combine objects and real marks in one projection. Each comes in wireframe and, where built, surface (filled with the brand accent). Click a tile to open it in the lightbox.
Composable objects
Building blocks for scenes, in scripts/iso/objects.mjs. The empty ring is a face slot that takes any token, chain, DEX or wallet mark.
Scenes
Objects and real chain, token and DEX marks in one projection, in scripts/iso/scene.mjs. Lit dots loop along the connection lines. Each mark's ids are namespaced per instance so gradients don't collide.
Generate the SVG from the scene, then embed the output inline:
# generate a bare SVG from any scene
node scripts/iso/mac-studio.mjs back > out.svg
node scripts/iso/macbook.mjs > out.svg
# standalone preview harness (dark panel) to iterate
node scripts/iso/mac-studio.mjs html > scripts/iso/mac-studio-preview.html
<!-- embed: a fixed-ink tile that pins light mode -->
<figure class="ds-iso-tile" data-theme="light">
<svg class="bb-iso" viewBox="…">…</svg>
</figure>
Every scene composes the shared engine scripts/iso/engine.mjs:
C: the white-on-ink palette (edge20% ·faint13% ·mark48% ·lit85%), each acolor-mixover--surface-page.SW: stroke weights (hair1.1 ·edge1.6 ·bold2.4) withvector-effect:non-scaling-stroke, so edges match across scenes at any viewBox scale.createIsoKit: the 2:1 dimetric projection plusslab()/keycap()for hardware scenes. Flat scenes (coin, swap) use the core only.autoFrame+wrapSvg: a square viewBox from the content bounds, and the SVG wrapper that adds the non-scaling-stroke rule.
Method and worked examples: the iso-illustration skill.
- Never hand-edit the SVG. Change the generator, regenerate and re-embed.
- Take every stroke from
SWand every colour fromC, so a new scene matches the rest. - Embed inline, on a
data-theme="light"ink tile. An<img>can't read--surface-pageor animate; the light pin keeps the white-on-ink look on any theme. - Outline only. The one fill is the moving element, such as a typed key or the flow pip.
/icons/. Each file has viewBox="0 0 24 24", stroke-width="2" and round caps and joins.119 icons · stroke-width="1.5" on Marketing surfaces, 2.0 on Product. Icons use currentColor, so they take the text colour.
<!-- Inline from /icons/ so currentColor works -->
<svg viewBox="0 0 24 24" fill="none"
stroke="currentColor" stroke-width="2"
stroke-linecap="round" stroke-linejoin="round">
<path d="M5 12h14"/>
<path d="M12 5v14"/>
</svg>
/* Sizes 14 / 16 / 18 / 20 / 24, set with width and height */
| Class / size | Use |
|---|---|
| .avatar | 40×40 default; a cluster wrapper can set --avatar-size |
| .avatar--xs | 24×24 · table cells, dense lists, chip slots |
| .avatar--sm | 32×32 · compact list leads, secondary identity rows |
| .avatar--lg | 48×48 · card thumbnails, stat tiles, "integrated with N chains" stacks |
| .avatar--xl | 64×64 · hero rows, feature cards, partner showcase |
| .avatar--2xl | 96×96 · marketing heroes, asset library hero tiles |
| .avatar--square | 4px radius · keeps the source geometry |
| .avatar--rounded | 25% radius · chips, badges, tiers |
| .avatar--circle | 50% radius · "latest integration" avatars |
- Stroke width.
1.5on Marketing and Docs surfaces,2.0on dense Product UI. - Use only icons in
/icons/. If the one you need isn't there, stop and ask before adding it from lucide.dev (or the brand's own assets for a logo). Don't paste a one-off SVG into a feature file. - Copy the path exactly from the library file. No rounded decimals (
4.93 → 4.9) and no older Feather paths, such as the old moonM21 12.79A9 9 0 1 1 11.21 3…. - One action, one icon. Edit, save, delete, copy, more and back each use the same glyph everywhere. Find the existing one (
theme-card-edit,copy-button) before adding another;pencilnext topencil-linefor the same action is the most common drift. - Chain, token and partner logos go in
.avatar, which supplies the plate. Files live in/avatars/{chains,tokens,dexs,bridges,wallets,exchanges,payments,social,lifi}/; check the file exists before referencing it. - Pick the shape by context. Square for tables, rounded for chips, circle for avatars.
- Don't mix Lucide with brand glyphs in one row. Lucide is chrome; brand glyphs are content.
/avatars/.avatar at any size or shape. For wordmarks, use Partner Logos; for photos, Portraits.216 avatars across 10 categories · rendered at 40px. Solana tokens are temporary PNGs.
Chains · 80
Kebab-case full name.
Tokens · 36
Lowercase ticker.
Solana tokens · 5
Lowercase ticker. Circular coin art, so use .avatar--circle.
Temporary PNG placeholders. SVGs will replace them under the same filenames.
DEXs · 34
Kebab-case full name.
Bridges · 29
Kebab-case full name, with a version suffix when relevant (across-v3).
Wallets · 9
Kebab-case full name.
Exchanges · 3
Centralized exchanges. Kebab-case full name.
Payments · 3
Card and payment products. Kebab-case full name.
Social · 12
Numbered placeholders, still to be renamed.
LI.FI · 5
LI.FI's wordmark, mark and product sub-brands.
<!-- 40px default; sizes .avatar--xs / --sm / --lg / --xl / --2xl -->
<span class="avatar">
<img src="/avatars/chains/ethereum.svg" alt="Ethereum">
</span>
<!-- Stacked / overlapping -->
<span class="avatar-stack avatar-stack--tight">
<span class="avatar">…</span>
<span class="avatar">…</span>
</span>
| Folder | Count | Naming | Examples |
|---|---|---|---|
| /avatars/chains/ | 80 | kebab-case full name | ethereum, arbitrum, base, optimism, polygon, solana |
| /avatars/tokens/ | 36 | lowercase ticker | eth, usdc, usdt, dai, steth |
| /avatars/solana/ | 5 | lowercase ticker · temporary PNG | bonk, jto, jup, ray, wif |
| /avatars/bridges/ | 29 | kebab-case full name | across-v3, stargate-v2-fast-mode, hop, celer-cbridge, circle-cctp |
| /avatars/dexs/ | 34 | kebab-case full name | uniswap, curve, 1inch, paraswap |
| /avatars/wallets/ | 9 | kebab-case full name | metamask, phantom, coinbase-wallet, walletconnect, ledger, rabby |
| /avatars/exchanges/ | 3 | kebab-case full name | binance, coinbase, okx |
| /avatars/payments/ | 3 | kebab-case full name | kast, mastercard, visa |
| /avatars/social/ | 12 | numeric placeholder | alt-1 … alt-12 (rename target) |
| /avatars/lifi/ | 5 | product name (no lifi- prefix) | lifi, collector, composer, pioneer, wrapper |
Tokens use the ticker because trading and wallet UI refer to them that way (eth.svg, not ethereum-token.svg).
- Use the plate in the file. Don't add your own; the source already has the padding
.avatarexpects. - The default size is 40px, with no modifier.
- A wordmark is not an avatar. A logo with brand typography goes in
logos/partners/as a-dark/-lightpair, rendered through.ds-doc-partner-logo. - Reference by path (
../avatars/chains/foo.svg); never paste an SVG inline. - When you import a new avatar, ask the user to add a cell to this grid. The grid doesn't update itself.
- Compress on import. Brand-page SVGs are often over 50KB; SVGO and manual cleanup get them under 4KB.
/logos/partners/.ds-doc-partner-logo. For icon-only marks, use Avatars.29 partners · 58 SVGs in -dark / -light pairs · rendered at 32px. Switch the theme to see the other version.
<span class="ds-doc-partner-logo ds-doc-partner-logo--md" role="img" aria-label="MetaMask">
<img class="ds-doc-partner-logo__dark" src="logos/partners/metamask-dark.svg" alt="">
<img class="ds-doc-partner-logo__light" src="logos/partners/metamask-light.svg" alt="">
</span>
Both <img> tags ship; CSS shows one per theme. Put the brand name in the wrapper's aria-label and leave each alt empty.
| Class | Role | Notes |
|---|---|---|
| .ds-doc-partner-logo | Wrapper, height-constrained | Inline-flex; default 32px high (--md) |
| .ds-doc-partner-logo--sm / --md / --lg | Size modifiers | 24 / 32 / 40 px high; width follows the aspect ratio |
| .ds-doc-partner-logo__dark | Dark-theme variant | Visible by default; hidden on light |
| .ds-doc-partner-logo__light | Light-theme variant | Hidden by default; visible on light |
| .ds-doc-partner-logo-grid | Catalog grid | auto-fill, min cell 220px |
| .ds-doc-partner-logo-cell | Catalog cell | Plate + figcaption around one wordmark |
- Wordmarks only. A partner with only a square mark uses
.avatar. - Always ship a
-dark/-lightpair. One version breaks the theme swap; a partner with only one goes through.avatar. - Label the wrapper, not the images. The
<span>carries the role andaria-label; the images takealt="". - Don't tint or recolour. No opacity overrides and no greyscale.
- Compress on import. Wordmark SVGs often carry unused glyph paths; SVGO and manual cleanup get most under 6KB.
/portraits/.avatar with <img srcset>. Procedure: design.md §05 → People asset library.5 portraits in Personas and Team. The external/ bucket is empty until consented photos arrive. Each bucket has its own usage rules (see Rules).
Personas · 4
Fictional: Kim (Shrimp, first-time DeFi), Finn (Fish, active trader), Dale (Whale, ETH maxi), Mabel (Stablecoin Maxi). Free to use in demos, explorations and marketing.
Team · 1
Real LI.FI team; internal sign-off required before any external use. Vilen Rodeski (Director of Design) is the first entry.
Plate options · 9
Three accent solids, two neutrals (ink, paper) and three brand gradients. Pick by the surface, not the person. For a one-off plate, set style="--avatar-bg: …".
Shape options · 3
Portraits default to the circle. Use rounded on feature cards and pricing tiers, square in table cells.
<!-- Circle, brand-gradient plate behind the transparent PNG -->
<img class="avatar avatar--lg avatar--circle avatar--plate-brand"
src="../portraits/personas/kim-96.png"
srcset="../portraits/personas/kim-96.png 96w,
../portraits/personas/kim-256.png 256w,
../portraits/personas/kim.png 1024w"
sizes="(max-width: 600px) 48px, 96px"
alt="Kim — Shrimp persona">
<!-- Plates: .avatar--plate-primary / -secondary / -tertiary -->
<!-- -ink / -paper · -brand / -brand-rich / -brand-radial · -none -->
<!-- Shapes: .avatar--square / -rounded / -circle -->
<!-- Custom: style="--avatar-bg: oklch(60% 0.18 200);" -->
- Personas: free to use on public surfaces, decks and demos. They are fictional and were generated for the system.
- Team: internal sign-off before any external use (marketing, decks shared outside the company, the public site). Add the master at
portraits/team/<firstname>-<lastname>.png. - External: explicit consent per person, often with an expiry. Ask before each new use, since the terms may have lapsed.
- Never use a real person's photo as a persona, or a persona as a real person.
- No tints or backgrounds inside the PNG. For a coloured ground, use
.avatar--plate-*or--avatar-bg.