Triage design system v0.13.1-experiment
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 ≤767px

Nav 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

Messages

Newest first — select rows to act in bulk.
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-area

Tabs

All messages 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>
Navigate
Actions
↑↓ navigate↵ runesc close

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

ElementRule
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
Scrimrgba(0,0,0,.35) at z-35; Escape and outside click close the drawer
Card headersevery 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/.