.app-rail shell holding the brand lockup, search, org switcher, nav and account chip, all existing primitives.Rail panel .portal-rail
The fixed left rail on a glass .panel: head, search, org, nav, footer. All four corners are rounded.
The real rail markup, set to position: relative with its JS hooks removed. Its parts: Brand lockup, Search trigger, Dropdown, Side nav, Avatar (initial).
<!-- Fixed left rail — composes .panel + the shared .app-rail shell -->
<aside class="panel app-rail portal-rail" data-screen="root" aria-label="Portal navigation">
<div class="app-rail__screen is-active" data-screen-id="root">
<header class="app-rail__head">
<a class="brand-lockup brand-lockup--back">…</a>
<div class="portal-rail__actions"><!-- theme · bell · .portal-rail__toggle --></div>
</header>
<div class="portal-rail__search"><button class="search-trigger">…</button></div>
<div class="portal-rail__org"><div class="dropdown">…</div></div>
<div class="app-rail__section portal-rail__nav">
<nav class="side-nav side-nav--lg">…</nav>
</div>
</div>
<footer class="app-rail__footer portal-rail__foot">…</footer>
</aside>
The root is the rail's only .app-rail__screen. The head's .portal-rail__toggle (data-action="rail-toggle") flips body.is-rail-mini, a click-toggle collapse.
| Property | Value | Source |
|---|---|---|
| Width | --w-4 (320 px) | Scoped override body.portal-body { --rail-width: var(--w-4) } — shared .app-rail default is --w-6 |
| Collapsed width | --rail-mini (72 px) | body.is-rail-mini shrinks --rail-width — click-toggle PUSH, portal.css → "Collapsed (mini) rail" |
| Radius | --panel-radius (16 px) ×4 | .portal-rail override |
| Surface | --surface-panel-glass | .panel glass recipe |
| Elevation | --elev-3 | .panel |
| Position | fixed, full height | .app-rail |
| Gutter | --panel-padding (24 px) | .panel |
Unlike the playground rail, all four corners keep --panel-radius: there is no .drawer-handle to meet a squared corner.
| Slot | Class | Holds |
|---|---|---|
| Shell | .panel.app-rail.portal-rail | Glass surface, fixed geometry, full radius |
| Screen | .app-rail__screen | The root view — the rail's only screen today; only .is-active shows |
| Head | .app-rail__head | .brand-lockup (left) + .portal-rail__actions (theme · bell · collapse toggle) |
| Search | .portal-rail__search | A full-width .search-trigger (⌘K) |
| Org | .portal-rail__org | The .dropdown organization switcher |
| Nav | .app-rail__section.portal-rail__nav | The flush, full-width .side-nav.side-nav--lg |
| Footer | .app-rail__footer.portal-rail__foot | Support / Docs links + account chip; pins to the bottom |
- Full radius on all four corners.
.portal-railresets the shared rail's squared top-right to--panel-radius, so it follows the corners composer. - Compose, don't re-chrome. Surface, elevation, radius and padding come from
.paneland.app-rail. A hand-setbackground,box-shadoworborder-radiuson the rail is drift. - Collapse is a click toggle that pushes the canvas.
body.is-rail-minishrinks--rail-widthto--rail-mini(72 px). - Nav runs flush. The 24 px panel gutter is the only inset, so nav rows align with the lockup and search above.
- Nav rows fill the width, so every hover and active fill is the same width.
CSS: portal.css, search .portal-rail and "Collapsed (mini) rail"; the shared shell is .app-rail in styles.css.
Markup: portal.html — the <aside class="panel app-rail portal-rail"> block. JS: portal.js → initPortalRailToggle (the collapse toggle).
Spec: CLAUDE.md → "LI.FI Portal — partner console" (Shell section) and "Panel primitive".
.portal-page-head on top-level pages, .portal-entity-head on pages opened from a parent (Integration detail).Page header .portal-page-head
Title, with an optional sub line and right-aligned actions.
All slots
Welcome back, Vilen
Here's what's moving across your integrations.
Title only
Members
Title and sub
Status
All systems operational — historical uptime and recent incidents below.
Title and actions
API keys
<!-- Sub and actions are optional -->
<div class="portal-page-head">
<div>
<h1 class="portal-page-head__title">Welcome back, Vilen</h1>
<!-- optional -->
<p class="portal-page-head__sub">Here's what's moving across your integrations.</p>
</div>
<!-- optional -->
<div class="portal-page-head__actions">
<button class="btn-secondary btn-with-icon">…</button>
<button class="btn-primary btn-with-icon">…</button>
</div>
</div>
| Property | Value | Token / notes |
|---|---|---|
| Layout | flex, align-end, space-between | title group · actions group |
| Gap (title↔actions) | 24 px | --space-24 |
| Margin-bottom (header→content) | calc(--grid-gap-y + 8) | tracks the Spacing composer + one ladder step extra header breathing |
| Title | --text-h1 | weight --fw-bold, tracking tight, line-height 1.1 |
| Sub (eyebrow→title) | 12 px | --space-12 — internal rhythm |
| Sub (title→sub) | 12 px | --space-12 — internal rhythm |
| Sub copy | --text-body | --text-muted |
| Actions gap | 12 px | --space-12 |
| Class | Required? | Role |
|---|---|---|
| .portal-page-head | Required | Flex container: title group · actions group |
| .portal-page-head__title | Required | The page title (H1) |
| .portal-page-head__sub | Optional | One-line muted context line |
| .portal-page-head__actions | Optional | Right-aligned cluster of page-level secondary + primary buttons |
| .portal-page-head__eyebrow | Optional · reserved | Parent-section label above, for Analytics children; --accent-primary |
- Only the title is required. Don't add a sub line or a one-button actions row just to fill the slot.
- Pick by tier, not content. Top-level pages (Dashboard, Members, Settings, Analytics root) use
.portal-page-head; pages opened from a parent (Integration detail, Analytics → Volume) use.portal-entity-head. - Actions apply to the whole page (New integration, Add member, Withdraw fees). A panel's own actions go in that panel's header.
- Top space is not a header margin. It is
--canvas-top(24 px) plus.portal-view__inner's 32 px top padding; don't pad the header. - Bottom space follows the Spacing composer:
calc(--grid-gap-y + --space-8).
CSS: portal.css — search .portal-page-head.
Tier: page-local tier-3 .portal-* — promotion candidate once a 2nd consumer appears.
Spec: CLAUDE.md → "LI.FI Portal — partner console".
Entity header .portal-entity-head
Eyebrow, avatar, name with status chip, integrator string, actions. Only avatar and title are required.
All slots
oneinteg10
ActiveNo eyebrow, top-level entity
oneinteg10
ActiveNo actions, read-only entity
oneinteg10
ArchivedAvatar and title only
oneinteg10
<!-- Every slot beyond avatar + title is optional -->
<!-- optional · parent-section label (sibling) -->
<div class="portal-entity-head__eyebrow">Integrations</div>
<div class="portal-entity-head">
<span class="avatar avatar--initial avatar--rounded portal-entity-head__avatar" data-initial="oneinteg10"></span>
<div class="portal-entity-head__id">
<div class="portal-entity-head__title-row">
<h1 class="portal-entity-head__title">oneinteg10</h1>
<!-- optional · status chip -->
<span class="chip chip-success chip--sm">…</span>
</div>
<!-- optional · mono integrator-string + copy -->
<div class="portal-entity-head__sub">…</div>
</div>
<!-- optional · right-aligned actions -->
<div class="portal-entity-head__actions">…</div>
</div>
| Property | Value | Token / notes |
|---|---|---|
| Layout | flex, align-start, gap 16 | avatar · id (flex-1) · actions |
| Margin-bottom (header→content) | calc(--grid-gap-y + 8) | matches .portal-page-head — same canvas rhythm |
| Avatar | 56 px square | .portal-entity-head__avatar over .avatar--initial (rounded) |
| Eyebrow | --text-caption | bold, tracking wide, uppercase, --accent-primary; margin-bottom 12 |
| Title | --text-h2 | weight --fw-bold, tracking tight, line-height 1.1 |
| Title-row gap | 12 px | --space-12 |
| Sub | --text-sm | --text-muted, mono string + copy button; margin-top 8 |
| Actions gap | 8 px | --space-8 |
| Class | Required? | Role |
|---|---|---|
| .portal-entity-head__eyebrow | Optional | Parent-section label above; omit on top-level entity pages |
| .portal-entity-head | Required | Flex row: avatar · id · actions |
| .portal-entity-head__avatar | Required | 56 px square initial avatar (rounded) |
| .portal-entity-head__id | Required | Title-row + sub-line, takes remaining width |
| .portal-entity-head__title-row | Required | Name + optional status chip on one line |
| .portal-entity-head__title | Required | Entity name (H1) |
| .chip (in title-row) | Optional | Status chip — Active / Paused / Archived |
| .portal-entity-head__sub | Optional | Mono integrator-string + copy affordance |
| .portal-entity-head__actions | Optional | Right-aligned secondary action buttons |
- The eyebrow names the parent section only (
Integrations), in--accent-primary. Top-level entity pages omit it. - The status chip sits on the title row (Active, Paused, Archived), not in the sub line.
- The integrator string is copyable. Pair it with the copy button; engineers paste it into the SDK.
- Actions are secondary. View and edit use
.btn-secondary; the primary action (Withdraw fees) lives in the Overview metric cards. - Minimal form keeps avatar and title. With only a title, use
.portal-page-head.
CSS: portal.css — search .portal-entity-head.
Tier: page-local tier-3 .portal-* — promotion candidate once a 2nd consumer appears.
Spec: CLAUDE.md → "LI.FI Portal — partner console".
Empty-state illustration .portal-empty__art
Decorative art for the "create your first integration" empty state.
Sits above .portal-empty__title, .portal-empty__desc, an actions row and a 3-up .portal-steps grid.
<div class="portal-empty__art" aria-hidden="true">
<span class="portal-empty__card portal-empty__card--back"></span>
<span class="portal-empty__card portal-empty__card--front">
<span class="portal-empty__check"><svg>…</svg></span>
<span class="portal-empty__lines"><i></i><i></i></span>
</span>
<span class="portal-empty__fab"><svg>…</svg></span>
</div>
| Property | Value | Token / notes |
|---|---|---|
| Frame | max 440 × 180 px | --card-radius, --surface-raised |
| Dotted grid | 16 × 16 px | radial-gradient, ink 8% mix |
| Front card | 204 × 104 px | accent 6% fill, accent 30% border, --elev-1 |
| FAB | 40 px | --accent-primary, --elev-2 |
| Class | Role |
|---|---|
| .portal-empty__art | Dotted-grid frame containing the overlapping cards |
| .portal-empty__card--back / --front | The two stacked card silhouettes |
| .portal-empty__check | Accent check disc on the front card |
| .portal-empty__lines | Two faux text lines (80% / 50% width) |
| .portal-empty__fab | Floating add-button in the corner |
- Decorative: mark it
aria-hidden="true"; the heading and description carry the meaning. - Always pair it with copy and the "New integration" button.
- Integrations only. Other empty states get their own art or a plain
.portal-placeholder.
CSS: portal.css — search .portal-empty__art (the .portal-empty / .portal-steps block).
Tier: page-local tier-3 .portal-* — promotion candidate once a 2nd consumer appears.
Spec: CLAUDE.md → "LI.FI Portal — partner console".
Usage meter .portal-usage
N / M plan usage with a mini bar; --limit turns it danger at capacity.
Within plan
6 / 10 integrationsAt capacity
2 / 2 integrations<span class="portal-usage">
<span class="portal-usage__bar">
<span class="portal-usage__fill" style="width: 60%;"></span>
</span>
<span class="portal-usage__text"><strong>6</strong> / 10 integrations</span>
</span>
<!-- At capacity: add --limit -->
<span class="portal-usage portal-usage--limit">…</span>
| Property | Value | Token / notes |
|---|---|---|
| Pill | 4 / 12 padding | --r-full, --surface-card, --border-subtle |
| Bar | 40 × 4 px | --r-full, ink 12% track |
| Fill | width % | --accent-primary (→ --danger on --limit) |
| --limit | danger tone | danger 40% border, 6% fill, danger value ink |
| Class | Role |
|---|---|
| .portal-usage | Pill wrapper (bordered, rounded-full) |
| .portal-usage__bar | Track for the progress fill |
| .portal-usage__fill | Filled portion — width = the N / M fraction |
| .portal-usage__text | Label; strong emphasises the current count |
| .portal-usage--limit | Danger-tone modifier for the at-capacity state |
The bare .portal-usage__bar is also the onboarding progress bar, .portal-onboard-bar.
- The
__fillwidth must equal N / M. - Use
--limitonly at capacity, with a disabled "New integration" button and a contact-support note. - Keep the label to "N / M integrations". Plan detail goes in the sibling
.portal-meta-row__note.
CSS: portal.css — search .portal-usage.
Tier: page-local tier-3 .portal-* — promotion candidate once a 2nd consumer appears.
Spec: CLAUDE.md → "LI.FI Portal — partner console".
integration-wizard.js) and the two pieces it adds: the wallet-family row and the in-field counter.Network row .network-row
One row per wallet family, with a Required or Optional chip and an add-wallet drawer.
The Wallets step adds one fee-collection wallet per network family. data-state sets the row's state.
Empty
Added
Adding, drawer open
Fees are sent to this address automatically. You can change it later in Fee Management.
<div class="network-row" data-family="svm" data-state="adding">
<div class="network-row__head">
<img class="avatar avatar--sm avatar--rounded network-row__icon" src="avatars/chains/solana.svg" alt="">
<div class="network-row__body">
<div class="network-row__name">SVM <span class="chip chip-warn chip--sm">Required</span></div>
<span class="network-row__sub">Solana · enter a Solana address</span>
</div>
<div class="network-row__trail"><!-- Add btn · Added chip + kebab · or "Adding" --></div>
</div>
<!-- form padding lives on __form, never .reveal__inner -->
<div class="reveal network-row__drawer"><div class="reveal__inner">
<div class="network-row__form">…</div>
</div></div>
</div>
Rendered by integration-wizard.js → networkRowHTML(); the form by walletFormHTML().
| Property | Value | Token / notes |
|---|---|---|
| Surface | --surface-card | card tier + --border-subtle + --elev-1 |
| Radius | --card-radius | 16 px |
| Head padding | 12 px | --space-12; row gap --space-12 |
| Row gap | 8 px | .network-row + .network-row → --space-8 |
| Drawer | 0fr → 1fr | grid-rows accordion, 0.28s ease |
| Adding rim | accent 64% | color-mix border + --elev-2 (card .is-active recipe) |
| Form padding | 12 px | on .network-row__form + a --border-subtle top rule |
| Class | Role |
|---|---|
| .network-row | The row; carries data-state="empty|added|adding" + data-family |
| .network-row__head | Avatar + body + trailing action, always visible |
| .network-row__icon | The family's .avatar (chain mark or the L2 plate) |
| .network-row__body | Name row + sub-line (truncating) |
| .network-row__name | Family name + Required/Optional .chip |
| .network-row__sub | Family blurb, or .mono short-address once added |
| .network-row__trail | Add .btn · Added .chip + remove kebab · "Adding" |
| .reveal + .network-row__drawer / .reveal__inner | The shared .reveal drawer, opened by data-state="adding"; inner stays bare |
| .network-row__form | Add-wallet form: owns padding + top rule; content is consumer-supplied |
| .network-row__addr | Address input + Paste button row |
| .network-row__form-actions | Right-aligned Cancel + Save |
| .network-row--l2 | Variant for the "Add an EVM L2 wallet" chooser row (select in the trail) |
data-statedrives all three states. The rim and open drawer are CSS on[data-state="adding"]; no JS toggles a class.- Form padding lives on
.network-row__form, not.reveal__inner, so0frcollapses to zero. - Required families (EVM, SVM) get
.chip-warn; optional ones (Bitcoin, Sui, Tron, L2) get.chip-neutral. - The row only adds framing and the drawer; everything inside is an existing primitive.
- One consumer today. Promote to
styles.csswhen a second "add accounts" flow appears.
CSS: portal.css — search .network-row.
JS: integration-wizard.js → networkRowHTML() + walletFormHTML() (the Wallets step).
Tier: page-local tier-3 — promotion candidate once a 2nd consumer appears.
Spec: CLAUDE.md → "LI.FI Portal — partner console".
In-field counter .input-counter
A live count inside a maxlength input's right edge, danger at the cap. Not the label-row .field-counter.
Under the cap
At the cap
<span class="input-counter">
<input class="input" type="text" maxlength="64">
<span class="input-counter__count" aria-hidden="true">15 / 64</span>
</span>
<!-- at the cap: add --over -->
<span class="input-counter__count input-counter__count--over">64 / 64</span>
| Property | Value | Token / notes |
|---|---|---|
| Wrapper | position: relative | display: block |
| Input pad-right | 64 px | --space-64, so text never runs under the count |
| Count position | right 16 px | --space-16, vertically centered, pointer-events: none |
| Count type | 14 px / 600 | --text-sm · --fw-semibold · tabular-nums |
| Count colour | --text-faint | → --danger on --over |
| Class | Role |
|---|---|
| .input-counter | Relative wrapper around the .input; reserves the count's right gutter |
| .input-counter__count | The absolutely-positioned "N / max" caption |
| .input-counter__count--over | At-cap state — recolours the count to --danger |
- JS updates the count and toggles
--over. CSS only places and colours it;maxlengthdoes the capping. - The count is
aria-hidden; it repeats themaxlengthlimit. - Overlay the field with
.input-counter; put the count in the label row with.field-counter. - One consumer today (the wizard name field). Promote to
styles.csswhen a second appears.
CSS: portal.css — search .input-counter.
JS: integration-wizard.js → basicsBody() (the name field).
Sibling: .field-counter (styles.css) — the label-row counter.
Tier: page-local tier-3 — promote to styles.css when a 2nd consumer appears.
Spec: CLAUDE.md → "LI.FI Portal — partner console".
Integration wizard .iwiz
Stepper, per-step head and body, and one footer pattern.
A snapshot of the String step: stepper, head, body (list-card radios and an alert) and footer. The live flow is in portal.html under New integration.
Choose your string
<!-- portal.html — the thin shell -->
<div class="modal-overlay" id="integrationWizardModal" hidden>
<div class="modal panel modal--lg iwiz" role="dialog" data-integration-flow></div>
</div>
// integration-wizard.js: renderStep() fills it per step
flow.innerHTML =
'<div class="iwiz__top">' + stepper + '</div>' // stepper
+ '<div class="modal-body">' + head + stepBody + '</div>' // head + body
+ '<footer class="iwiz__footer">…</footer>'; // footer
The four steps
| Step | Collects | Continue when |
|---|---|---|
| Basics | Name (.input-counter) + optional URL | name is non-empty |
| String | The permanent integrator string (suggested or custom) | string ≥ 3 chars |
| Wallets | One .network-row per family (EVM + SVM required) | EVM and SVM added |
| API key | Reveal-once key + a "saved it" confirmation | confirmation checked |
Footer model
| Step | Left | Right cluster |
|---|---|---|
| Basics (first) | Cancel | Continue |
| String / Wallets (middle) | Cancel | ← Back · Continue |
| API key (last) | Cancel | Confirm and finish |
Wallets shows a block reason ("SVM wallet required") left of Back until both required wallets are added. Width: .modal--lg (576 px).
| Layer | Role |
|---|---|
| .modal.panel.modal--lg.iwiz | The shell, inside a .modal-overlay; .iwiz sets the column gap |
| .iwiz__top | Full-width .steps--circles-inline stepper (no top-right close) |
| .iwiz__head / __title / __desc | Per-step heading unit inside .modal-body |
| .iwiz__section-label | Mono uppercase group label ("Network families", "API key") |
| .iwiz__alert | Top-aligned .alert for the permanent-string + reveal-once warnings |
| .iwiz__required-progress | "Required wallets added · N / 2" line above the footer |
| .iwiz__key-actions / __saved-card | API-key step: Copy + Download row · "I've saved it" .option-card |
| .iwiz__footer / __footer-left / -right / __status | Cancel left; Back + primary right; block-reason status |
.iwiz__*is layout only. Everything else is an existing primitive.- No top-right close. Cancel, bottom-left, dismisses on every step; ESC and an overlay click also close.
- Back appears on the middle steps only, left of the primary.
- Back goes to the previous step. This is the wizard exception to the modal rule that back returns to Main.
- Finish emits
lifi:integration-created{ name, string, wallets };portal.jssaves it and opens its Detail page.
JS: integration-wizard.js (window.LifiIntegrationWizard.initWizard); the shell is portal.html → #integrationWizardModal, opened via [data-action="open-integration-modal"].
CSS: portal.css — search .iwiz (the flow-specific layout glue).
Spec: CLAUDE.md → "LI.FI Portal — partner console".
.panel.portal-panel.Fee table & summary .portal-fee-chain · .portal-fee-bar · .portal-fees-summary
The Fees tab: a total, lifetime and rates summary above a per-chain collectable table.
Summary
Per-chain table
| Chain | Collectable | Transactions | Last collected |
|---|---|---|---|
| $7,000,000 | 56,204 | 12h ago | |
| $3,000,000 | 24,891 | 5h ago | |
| $92,410 | 1,208 | 3d ago |
Bar width is each balance as a fraction of the largest, not of the total.
<!-- Per-chain cell: avatar + name + native amount -->
<span class="portal-fee-chain">
<img class="avatar avatar--circle" src="avatars/chains/optimism.svg" style="--avatar-size: var(--space-28);">
<span>
<span class="portal-fee-chain__name">Optimism</span>
<span class="portal-fee-chain__amt mono">2.4081 ETH</span>
</span>
</span>
<!-- Relative-magnitude bar in the Collectable cell -->
<span class="portal-fee-bar"><span class="portal-fee-bar__fill" style="width: 43%;"></span></span>
| Property | Value | Token / notes |
|---|---|---|
| Summary | 1fr 1fr 1.5fr | hairline divider between columns, gap 24 |
| Summary value | --text-h1 | weight --fw-bold, tracking tight |
| Fee bar | 96 × 4 px | --r-full, ink 10% track, --accent-primary fill |
| Chain avatar | 28 px | --avatar-size: var(--space-28) |
| Class | Role |
|---|---|
| .portal-fees-summary | 3-column total / lifetime / rates grid |
| .portal-fees-rate | Rate row — label + .chip badge |
| .portal-fee-chain | Table cell — avatar + name + native amount |
| .portal-fee-bar / __fill | Relative-balance mini bar in the Collectable cell |
| .portal-fee-age | Status dot + relative time in Last-collected |
- Scale each bar to the largest chain balance, not the grand total.
- The mono
__amtline shows the token amount; fiat sits in the Collectable column. - Every numeric cell uses tabular-nums.
- Chain marks are
.avatarfrom/avatars/chains, never a Portal-specific mark.
CSS: portal.css — search Detail · Fees tab (the .portal-fees-* / .portal-fee-* block).
Tier: page-local tier-3 .portal-* family — promotion candidate once a 2nd consumer appears.
Spec: CLAUDE.md → "LI.FI Portal — partner console".
Metric card .portal-metric
Icon label, large value, and a button or note pinned to the bottom.
<div class="panel portal-panel portal-metric">
<div class="portal-metric__head"><svg>…</svg><span>Collectable fees</span></div>
<div class="portal-metric__value">$1,284.32</div>
<button class="btn-primary btn-block">Withdraw fees</button>
</div>
<!-- --ok tone, note instead of a button -->
<div class="portal-metric__value portal-metric__value--ok">99.98%</div>
<span class="portal-metric__note">Last 30d uptime</span>
| Property | Value | Token / notes |
|---|---|---|
| Card | flex column | .panel.portal-panel surface, gap 12 |
| Head | --text-sm | --text-muted, icon in --text-faint |
| Value | --text-h2 | weight --fw-bold; --ok → --success |
| Footer | margin-top auto | .btn-block pinned to bottom for even card heights |
| Class | Role |
|---|---|
| .portal-metric | Flex-column body inside a .panel.portal-panel |
| .portal-metric__head | Icon + label row, muted |
| .portal-metric__value | Large headline number |
| .portal-metric__value--ok | Success-toned value (health / uptime) |
| .portal-metric__note | Caption alternative to a footer button |
- One
.btn-block(Withdraw, Request) or one__noteper card, never both. - The footer pins to the bottom (
margin-top:auto), so mixed-height cards align. --okonly recolours the value to--success; size and weight stay.
CSS: portal.css — search .portal-metric.
Tier: page-local tier-3 .portal-* — promotion candidate once a 2nd consumer appears.
Spec: CLAUDE.md → "LI.FI Portal — partner console".
Bar list .portal-barlist
Ranked breakdown with a proportional bar per row: Top chains, fee splits, Top routes.
Single chain
Route pair
<!-- Base row: single chain -->
<div class="portal-barlist">
<div class="portal-barlist__row">
<span class="portal-barlist__label"><img class="avatar avatar--circle" …>Ethereum</span>
<span class="portal-barlist__val">$18.4M</span>
<span class="portal-barlist__track"><span class="portal-barlist__fill" style="width: 100%;"></span></span>
</div>
</div>
<!-- Route row: avatar-stack, chain, arrow icon, chain -->
<div class="portal-barlist__row portal-barlist__row--route">
<span class="portal-barlist__label">
<span class="avatar-stack avatar-stack--xs"><img …><img …></span>
<span class="portal-route__name">Ethereum</span>
<svg class="portal-route__arrow-icon">…</svg>
<span class="portal-route__name">Arbitrum</span>
</span>
<span class="portal-barlist__val">$6K</span>
<span class="portal-barlist__track">…</span>
</div>
| Property | Value | Token / notes |
|---|---|---|
| Row grid | minmax(0,1fr) auto | label | value; track spans 1 / -1 below |
| Row gap | 8 / 12 | --space-8 row · --space-12 column; list gap --space-16 (route lists step up to --space-24) |
| Label / value | --text-sm | route variant bumps to --text-body |
| Track | height 8 | --space-8 · --r-full · 8% text-primary groove. --sm → --space-4 |
| Fill | width % | --accent-primary · set inline from pctOfMax |
| Route avatars | .avatar-stack--xs | 24px overlapping pair (margin-right --space-4); arrow icon --space-16; label gap --space-4 |
| Class | Role |
|---|---|
| .portal-barlist | Flex-column list of ranked rows, gap 16 |
| .portal-barlist--sm | Size variant — thinner 4px track (vs the default 8px) |
| .portal-barlist__row | Grid row — label + value, track below |
| .portal-barlist__row--route | Route variant — avatar-stack + dual chain label, bumped type |
| .portal-barlist__label | Avatar(s) + name(s); min-width:0 to share the row |
| .portal-barlist__val | Right-aligned magnitude value, tabular figures |
| .portal-barlist__track | Full-width bar groove (spans both columns) |
| .portal-barlist__fill | Accent fill; width = value ÷ max |
| .portal-route__name | Chain label inside a route row (nowrap) |
| .portal-route__arrow-icon | Lucide arrow-right ICON between the two chains |
- Fill is
round(value / maxValue × 100)%, with a 6–10% floor so the smallest bar shows. - Base row for one chain or fee type;
--routefor a from→to pair. - Route arrows are the Lucide
arrow-rightSVG (.portal-route__arrow-icon), never a→character. - Sort descending.
CSS: portal.css — search .portal-barlist (route variant: .portal-barlist__row--route).
Renderers: portal-render.js — barlistChain() (single chain) · dashboard-routes (route rows).
Tier: page-local tier-3 .portal-* — promotion candidate once a non-Portal surface needs a ranked bar breakdown.
Spec: CLAUDE.md → "LI.FI Portal — partner console".
Onboarding checklist .portal-checklist
Onboarding steps with done and todo markers, a resume link and a progress bar.
- Create integration
- Add a fee wallet
- Generate first API key
- Send a test transaction Resume →
- Invite a teammate
<!-- Progress bar reuses the usage-meter track -->
<span class="portal-usage__bar portal-onboard-bar"><span class="portal-usage__fill" style="width: 60%;"></span></span>
<ul class="portal-checklist">
<li class="is-done"><span class="portal-check"><svg>…</svg></span>Create integration</li>
<li><span class="portal-check portal-check--todo"></span>Send a test transaction
<a class="link-arrow" href="#">Resume →</a></li>
</ul>
| Property | Value | Token / notes |
|---|---|---|
| List | flex column, gap 12 | --text-sm, --text-primary |
| Check | 20 px | 50%, --accent-primary fill, on-accent glyph |
| Todo check | 20 px | transparent, 2px ink-25% border |
| Done row | line-through | --text-muted |
| Class | Role |
|---|---|
| .portal-checklist | Unstyled <ul> — flex-column step list |
| li.is-done | Completed step — muted, struck-through |
| .portal-check | Filled accent disc with a check glyph |
| .portal-check--todo | Empty outlined disc for a pending step |
| .portal-onboard-bar | Progress bar — reuses .portal-usage__bar |
- Done is a filled check with line-through; todo is an outlined disc. Shape carries state, not colour alone.
- Only the first incomplete step gets the
.link-arrow. - The
.portal-onboard-barfill equals done / total.
CSS: portal.css — search .portal-checklist.
Tier: page-local tier-3 .portal-* — promotion candidate once a 2nd consumer appears.
Spec: CLAUDE.md → "LI.FI Portal — partner console".
Wallet group .portal-wallet-group
Fee receivers per virtual machine: a default address, nested per-chain overrides, and an empty state.
Default and per-chain overrides
Default address used across all EVM chains, plus per-chain overrides.
-
Collected$842.10Default EVM DEFAULT · Ethereum0x2e8a346Ba1E0c7f9913282AFB2705CD00754E478
-
Collected$157.56Base override · Base0x4DFbc42E1e86Fb747A69a3Dc75BA8d6bD0cC7818
Not configured
UTXO chains. Not configured for this integration yet.
<div class="portal-wallet-group">
<div class="portal-wallet-group__head">
<div>
<div class="portal-wallet-group__title">EVM Networks <span class="chip chip-neutral chip--sm">1 default · 1 override</span></div>
<p class="portal-wallet-group__desc">Default address …</p>
</div>
</div>
<!-- Default row -->
<ul class="list list--cards"><li class="list-item">…</li></ul>
<!-- Per-chain overrides nest beneath a connector line -->
<div class="portal-wallet-overrides">
<ul class="list list--cards"><li class="list-item">…</li></ul>
</div>
</div>
| Property | Value | Token / notes |
|---|---|---|
| Group gap | 32 px | between adjacent .portal-wallet-group |
| Overrides indent | 24 / 16 px | margin-left + padding-left, 1.5px left connector |
| Rows | — | design-system .list.list--cards + .list-item |
| Empty | dashed | .portal-wallet-empty, --border-subtle |
| Class | Role |
|---|---|
| .portal-wallet-group | One virtual-machine group (EVM / SVM / Bitcoin) |
| .portal-wallet-group__head | Title + count chip + description + add-override CTA |
| .portal-wallet-overrides | Nested override list with a left connector line |
| .portal-wallet-chain | Muted "· <chain>" suffix on a row title |
| .portal-wallet-trail / -actions | Collected amount + per-row icon buttons |
| .portal-wallet-empty | Dashed not-configured placeholder row |
- Default first, overrides nested under
.portal-wallet-overrides, so precedence is visible. - One
.portal-wallet-groupper VM (EVM, SVM, Bitcoin); the count chip reads "N default · M overrides". - An unconfigured VM shows
.portal-wallet-emptywith an add button, not an empty table. - Rows are
.list.list--cardsand.list-item; the Portal classes only add the group frame.
CSS: portal.css — search .portal-wallet-group (the Detail · Wallets tab block).
Tier: page-local tier-3 .portal-* — promotion candidate once a 2nd consumer appears.
Spec: CLAUDE.md → "LI.FI Portal — partner console".
withdraw-fees.js), for one chain or as a multi-chain batch.Withdraw fees .wfee
Pick a chain's collectable tokens, sign, then a receipt or a revert.
States: select → signing → success | error. The live flow is any Withdraw button in portal.html; hold ⌥ to show the failure. Figures are one captured run.
Select
Withdraw fees
Select-all shows :indeterminate on a partial pick; the hero value turns faint when nothing is picked.
Success
Fees withdrawn
$31,359 across 3 tokens have been sent to your Arbitrum fee receiver.
- Transaction
- 0x7927…52b82
- Chain
Arbitrum
- Receiver
- 0x00e0…841f
- Gas paid
- $4.91
Receipt rows are a .detail-list--divided; the explorer link follows the chain.
Signing and revert
Error · Insufficient_gas
execution reverted: gas estimation failed at block 218682389
Signing puts a .spinner in the alert's .spot-icon. The revert is an .error-detail, which has no spot-icon by design.
<!-- portal.html — the thin shell -->
<div class="modal-overlay" id="withdrawFeesModal" hidden>
<div class="modal panel modal--lg wfee" role="dialog" data-withdraw-flow></div>
</div>
<!-- chain attr optional; omitted = largest remaining balance -->
<button class="btn-primary btn-sm" data-action="open-withdraw-modal"
data-withdraw-slug="ledger-live-swap" data-withdraw-chain="arbitrum">Withdraw</button>
// withdraw-fees.js: renderStep() fills the shell per state
flow.innerHTML = { select, signing, success, error }[state.step]();
The four states
| State | Shows | Advances when |
|---|---|---|
| Select | Amount hero · select-all · token rows · receiver note + gas | "Withdraw fees" with ≥ 1 token picked |
| Signing | Waiting banner · locked rows · disabled "Signing…" | Simulated signature lands (~2.2 s); Cancel returns to select |
| Success | Result disc · receipt · explorer link | Done or close |
| Error | Danger disc · revert copy · mono error detail | Try again re-signs (and succeeds) |
Data & consequences
| Call | Does |
|---|---|
| getWithdrawable(org, slug, chain?) | Seeded token split of the chain's collectable (native + stables, gov token past $250k); amounts derive from the price oracle at call time |
| recordWithdrawal(org, slug, chain, tokens) | Subtracts per token from every collectable surface, writes a "Just now" audit entry, fires 'change' (in-memory; resets on reload) |
| lifi:fees-withdrawn | Window event with { orgId, slug, chain, tokens, usdNum, txHash } for future consumers (+ batch: true on batch legs) |
Width is .modal--lg (576 px) throughout; height resizes per state. Gas is base + perToken × selected, seeded per chain. Earned figures (fees KPI, lifetime, transaction counts) never shrink.
| Layer | Role |
|---|---|
| .modal.panel.modal--lg.wfee | The shell, inside .modal-overlay; .wfee sets the column gap |
| .wfee__header / __chain-row / __bar | .screen-header title bar + centered .chip-avatar chain pill; result states keep only the close bar |
| .wfee__amount / -label / -value / -sub | Amount hero on the canonical card surface; --zero dims the value to faint ink |
| .wfee__selectbar / -count | "Select all" .checkbox (with the :indeterminate dash) + the n/m counter |
| .wfee__tokens (+ --locked) | .list--cards rows — checkbox + token avatar lead, amount-over-usd trail; locked during signing |
| .wfee__meta / -note / -gas | Receiver note + the count-scaled gas estimate |
| .wfee__signing-btn | Stock .alert--info with a .spinner in the .spot-icon disc · the disabled "Signing…" CTA |
| .wfee__result / __receipt | Result disc + title + desc · .detail-list--divided receipt card; the revert echo is the tier-2 .error-detail |
| .wfee__actions | Footer row — the primary grows, secondaries hug |
.wfee__*is layout only. Everything else is an existing primitive.- One chain, one transaction; the header pill names the chain. Without a chain attr the integration's largest remaining balance is used.
- With nothing picked, the hero value turns
--text-faintand the button disables; size and weight stay. - Signing dims only the checkboxes; the selection rim and content stay at full ink.
- Success drains every collectable surface live via
recordWithdrawaland'change', disables Withdraw on drained chains and logs "Just now". Earned figures don't shrink. - Cancel stops the signature and returns to select with picks kept; Escape and an overlay click close from any state.
- The sim always succeeds unless you hold ⌥ or call
LifiWithdrawFees.failNext(); Try again then succeeds.
JS: withdraw-fees.js (window.LifiWithdrawFees.init); the shell is portal.html → #withdrawFeesModal, opened via [data-action="open-withdraw-modal"] (emitted by portal-render.js on the Detail Fees + Fee Management tables).
CSS: portal.css → "WITHDRAW-FEES MODAL — .wfee".
Data: partner-orgs-data.js → getWithdrawable / recordWithdrawal (the in-memory withdrawn-fee ledger).
Spec: CLAUDE.md → "LI.FI Portal — partner console".
Batch withdraw .wfee__legs
"Withdraw all fees": one signature per chain, tracked in a checklist that becomes the receipt.
States: bselect → brun → bsummary. Scopes: one integration's chains (Detail → Fees) or every integration × chain pair (Fee Management). Hold ⌥ on Withdraw all fees to fail a leg. Figures are one captured run.
Paused on a failed leg
Withdraw all fees
A failed leg pauses the batch: Retry re-signs, Skip moves on, Stop ends it. The signing leg shows a .spinner and the selected tint.
Partial run summary
Partially withdrawn
$29,847 withdrawn on 2 of 4 chains. The rest stays collectable · withdraw it anytime.
Done legs get explorer links; the recap is the checklist in its final state.
Org-wide
Withdraw all fees
Org-wide (data-withdraw-all-org): one queue of chain legs, a .wfee__leg-group label per integration, and the org in the header pill.
<!-- data-withdraw-all opens the batch; portal-render.js stamps slug, disabled, gas -->
<button class="btn-primary btn-block btn-with-icon portal-fees-withdraw"
data-action="open-withdraw-modal" data-withdraw-all
data-withdraw-slug="ledger-live-swap">Withdraw all fees</button>
<!-- org-wide trigger (Fee Management): no slug -->
<button class="btn-primary btn-block btn-with-icon portal-fees-withdraw"
data-action="open-withdraw-modal" data-withdraw-all-org>Withdraw all fees</button>
// withdraw-fees.js: batch states share the single-flow shell
flow.innerHTML = { bselect, brun, bsummary }[state.step]();
<!-- org scope only: integration label before each cluster -->
<div class="wfee__leg-group">
<span class="avatar avatar--initial avatar--xs avatar--rounded">LS</span>
<span class="wfee__leg-group-name">Ledger Live Swap</span>
</div>
<!-- leg row: the checkbox slot becomes the status mark -->
<div class="list-item wfee__leg wfee__leg--done">
<span class="list-item__lead wfee__token-lead">
<span class="wfee__leg-mark wfee__leg-mark--done"><!-- check --></span>
<img class="avatar avatar--circle" src="avatars/chains/ethereum.svg">
</span>
<span class="list-item__body">
<span class="list-item__title">Ethereum</span>
<span class="list-item__desc wfee__leg-status">0x4be1…9c2af</span>
</span>
<span class="list-item__trail wfee__leg-trail">$18,420 · explorer link</span>
</div>
The three states
| State | Shows | Advances when |
|---|---|---|
| bselect | Amount hero · select-all-chains · one row per chain (symbols + per-leg gas) · signature-count note | "Withdraw fees" with ≥ 1 chain picked; every chain is pre-checked |
| brun | The checklist signing one leg at a time — waiting banner while signing, danger banner + Retry / Skip / Stop when a leg fails | Each landed leg advances automatically (~1.8 s sim); the last leg lands or Stop is pressed |
| bsummary | Graded result disc · the checklist in its final state with explorer links · total gas | Done or close |
Leg statuses
| Status | Mark | Status line |
|---|---|---|
| queued | Hollow ring | "Queued" |
| signing | .spinner--sm in the mark slot + selected row tint | "Awaiting signature…" |
| done | Filled --success disc, check | The short tx hash (tabular nums) |
| failed | Filled --danger disc, ✕ | "Reverted on-chain" in danger ink |
| skipped | Faint disc, minus | "Skipped · still collectable", muted title |
Data & consequences
| Call | Does |
|---|---|
| getWithdrawableAll(org, slug) | Per-chain array, largest first, drained chains dropped; it is the signing queue |
| getWithdrawableAllOrg(org) | Org-wide legs — every integration × chain pair, integrations largest-first; feeds the Fee Management trigger |
| recordWithdrawal(…) per leg | Fires as each leg lands, so surfaces drain one chain at a time |
| lifi:fees-withdrawn | One event per landed leg, same payload as the single flow + batch: true |
Gas is per leg (base + perToken × tokens, seeded per chain); bselect totals it.
| Layer | Role |
|---|---|
| .wfee__legs | The run / summary checklist — read-only .list--cards rows (pointer-events: none; explorer links re-enabled) |
| .wfee__leg-mark (+ --queued/--signing/--done/--failed/--skipped) | 20 px status disc in the checkbox slot |
| .wfee__leg--signing / --done / --failed / --skipped | Row state: selected tint on the signing leg; status ink per state |
| .wfee__leg-trail | Amount + the per-chain explorer icon-link (summary only) |
| .wfee__leg-group (+ -name) | Org-wide only: integration label (xs monogram + name) before each cluster |
| .wfee__chain-row (reused) | The pill names the scope (integration or org), never a chain |
| __amount / __selectbar / __meta / __actions (reused) | Hero, select-all, receiver and gas note, footer, from the single flow |
- A checklist, not a stepper. The steps are the chains, their count varies, and failure is a normal state.
- One signature per chain, since EVM has no cross-chain atomic withdraw. The hero sub line, meta note and trigger caption all state the count up front.
- Landed legs are final.
recordWithdrawalfires per leg, and a later Stop never rolls one back. - A failure pauses at that leg with Retry, Skip chain, Stop batch. Skipped and failed balances stay collectable.
- Stop with nothing landed returns to bselect with picks kept; with one or more landed it shows the partial summary.
- The batch picks whole chains; per-token picks stay in the single-chain flow.
- Integration batches use
data-withdraw-allplus slug; org-wide batches usedata-withdraw-all-org, group legs by integration, and key themslug|chain, because a chain alone is not unique across integrations. - The summary disc grades the outcome: success, warn (partial), danger (nothing withdrawn). Contact support appears only when a leg failed.
- Demo: hold ⌥ to fail the second leg;
LifiWithdrawFees.failNext()fails the next signature.
JS: withdraw-fees.js (window.LifiWithdrawFees.openAll integration-scoped / .openAllOrg org-wide; the engine is startBatch / advanceBatch / stopBatch); the Detail trigger is stamped per-integration by portal-render.js → renderDetail, the Fee Management trigger per-org by applyFeesWithdrawAll.
CSS: portal.css → "Batch legs" + .wfee__leg-group (under the .wfee block).
Data: partner-orgs-data.js → getWithdrawableAll / getWithdrawableAllOrg / recordWithdrawal.
Spec: CLAUDE.md → "LI.FI Portal — partner console".