Home / Components / Navigation & shell
Navigation & shell
The app shell, nav states, page frame and the phone-mode chrome — live at three widths.
App shell — live example
fixed 236px sidebar → off-canvas drawer ≤1023px → bottom tab bar ≤767pxNav item states
active = grey bg + 2px blue left rail; icons 16px stroke, opacity .72 (1 when active)
<a class="nav-item active" href="/" aria-current="page"> <svg …>…</svg>Dashboard </a> <a class="nav-item" href="/x">…<span class="badge warn" style="margin-inline-start:auto">3</span></a>
Page frame
Section heading
Settings-style section description between cards.
editors use a .backlink above the H1 — never a top-right Back button; .page-desc hides ≤767px
<div class="page-head">
<div><h1 class="page-title">Messages</h1>
<div class="page-desc">Newest first — select rows to act in bulk.</div></div>
<div class="row"><a class="btn primary">Action</a><a class="btn">Secondary</a></div>
</div>
<div class="backlink"><a href="…">← Automation</a></div>Phone mode — topbar, drawer, tab bar
iframe at 393px: bottom tab bar appears, hamburger hides, content clears the bar by 92px + safe-areaTabs
All messages panel.
Sorted panel.
Needs-reply panel.
components.js wires roles, roving tabindex and Arrow/Home/End keys; panels are hidden, never unmounted
<div class="tabs" data-tabs>
<div class="tablist" role="tablist" aria-label="Views">
<button class="tab" role="tab" aria-selected="true" aria-controls="p1">Overview</button>
<button class="tab" role="tab" aria-controls="p2">Activity</button>
</div>
<div class="tabpanel" id="p1" role="tabpanel">…</div>
<div class="tabpanel" id="p2" role="tabpanel" hidden>…</div>
</div>Breadcrumbs
ordered list + separators via CSS; aria-current on the leaf; collapses to the last two items on phones
<nav class="crumbs" aria-label="Breadcrumb"><ol> <li><a href="/automation">Automation</a></li> <li><span aria-current="page">Rule</span></li> </ol></nav>
Command palette
try filtering, ↑↓, Enter, Esc
cmd/ctrl+K opens the first palette on the page; items navigate via data-href or click data-cmd-action targets
<button class="btn" data-cmd-open>Command palette</button>
<dialog class="dlg cmd" id="cmd" aria-label="Command palette">
<input class="cmd-input" placeholder="Type a command…">
<div class="cmd-list" role="listbox">
<div class="cmd-group">Navigate</div>
<button class="cmd-item" data-href="/messages">Messages <span class="k">g m</span></button>
<button class="cmd-item" data-cmd-action="#refresh">Refresh now <span class="k">r</span></button>
</div>
<div class="cmd-hint"><span>↑↓ navigate</span><span>↵ run</span><span>esc close</span></div>
</dialog>Notification centre
unread = background + dot; opening the item clears it; the count lives in the summary's accessible name
<details class="menu notif" data-notif>
<summary class="btn small" aria-label="Notifications, 2 unread">Inbox <span class="notif-dot"></span>2</summary>
<div class="menu-pop notif-panel">
<div class="notif-item unread"><div><div class="t">…</div><div class="sub">…</div></div><span class="when">2m</span></div>
<div class="notif-foot"><button class="btn small" data-notif-read>Mark all read</button></div>
</div>
</details>Numbered pagination
…
current page is a real aria-current, not just ink fill; page-size select is present when the list is server-paged
<div class="pager-num"> <button class="pgn" aria-label="Previous page">←</button> <button class="pgn" aria-current="page">1</button> <button class="pgn">2</button><span class="pgn-gap">…</span> <label class="pager-size">Rows <select>…</select></label> </div>
Shell contract
| Element | Rule |
|---|---|
| Ids | #side #scrim #menuBtn #main are queried by shell.js — rename only with the script |
| Skip link | .skip first in body; focus moves it into view |
| Scrim | rgba(0,0,0,.35) at z-35; Escape and outside click close the drawer |
| Card headers | every card with a heading gets .card-h (h3 + right side) |
| Grids | .grid2 / .grid3 / .grid5 collapse at ≤767px; page grids at ≤1023px |
Triage Design System v0.13.1-experiment — the central, app-agnostic UI design authority.
Source of truth: /tokens/tokens.json. Showcase chrome only:
site/.