Skip to content
Design System
GitHub

Iconography

Lucide icons at a 2 px stroke, in three sizes tied to component heights. An icon always has a name, either a visible label or an accessible one.

Library

Lucide (lucide.dev): outline, 2 px stroke, 24 px grid. Do not mix in filled icons or other sets. The kit uses a fixed subset; the icon set lists each one with its meaning.

Square
Bluetooth
Wifi
Battery
Bell
Bot
House
ListChecks
Map
Video
Settings
CircleAlert

Browse all 168 icons and what each means

One icon, one meaning

An icon is a word. Once the dock is ChargingDock, it is ChargingDock on every screen, and ChargingDock means nothing else. Lint rejects a Lucide import outside the set, so a new icon or a second icon for a meaning is a reviewed change to site/icons.ts.

Send to dock Return to dock Dock
Do. Look the meaning up in the icon set and use its icon, every time.
Send to dock Return to dock Dock
Don't. Pick whatever looks close on each screen. This kit had three icons for the dock until the set existed.

Sizes

size-4 · 16Inside 36 px controls, menus, inline
size-5 · 20Inside 44–56 px controls, dock tabs
size-6 · 24Standalone, empty states

Status is a shape, not an icon

State uses the status glyph so it reads in colour and without it. Icons name things; glyphs say how they are.

  • Status
    active
    Means
    Busy, on a mission
  • Status
    normal
    Means
    Fine, waiting
  • Status
    warning
    Means
    Needs attention
  • Status
    danger
    Means
    Stopped or failed
  • Status
    offline
    Means
    Offline

Rules

Do. Pair an icon with a label, or give an icon-only button an aria-label and a tooltip.
Don't. Ship an icon-only button with no name. Screen readers announce “button” and nothing else.