Foundations · Iconography
Icons are wayfinding, not identity.
One Phosphor vocabulary, applied in context, sized on the lattice, and accountable to the people who rely on it.
List
Header · open navigation
24px · regular · aria-label on control
MagnifyingGlass
Header · search
16px · regular · visible label
ArrowRight
Button · continue
16px · bold · label carries meaning
ArrowUpRight
Footer · external link
16px · regular · destination is explicit
Phosphor set
One committed vocabulary.
A Phosphor glyph identifies an action, state, or direction.
The source brand never named an icon library. This commitment follows the dependency and contexts already present in the running book, while keeping unshipped roles visibly reserved.
In use
09Verified in the running book and chrome
- ListOpen navigationHeader.tsx · 24px · regular
- MagnifyingGlassSearchHeader.tsx · 16px · regular
- ArrowRightContinueButton.tsx · 16px · bold
- ArrowUpRightOpen externallyFooter.tsx · 16px · regular
- XDismiss navigationRail.tsx · 20px · regular
- LockMark unavailable groupsRail.tsx · 16px · regular
- CheckConfirm the disciplined exampleVoice.tsx · 16px · bold
- ArrowClockwiseAdvance a motion specimenMotionSpecimens.tsx
- ArrowCounterClockwiseReset an emphasis specimenEmphasisBench.tsx
Reserved
09Approved vocabulary without a shipped context
- PlayStart playbackReserved · labelled media controls only
- PausePause playbackReserved · labelled media controls only
- CaretRightDisclose a deeper levelReserved · no shipped context
- WarningFlag a cautionReserved · no shipped context
- InfoMark a definitionReserved · no shipped context
- GridFourReference the closed gridReserved · no shipped context
- CubeReference a moduleReserved · no shipped context
- CopyCopy a token or snippetReserved · no shipped context
- DownloadDownload an assetReserved · no shipped context
The rules
- Must
Draw interface icons from
@phosphor-icons/reactonly, to identify an action, a state or a direction.Extension
- Must not
Use icons as decoration or identity. An icon inherits its context; it does not decorate it, and reserved glyphs stay unused until a real context ships.
Extension
Weight & size
Calibrated to context.
Weight carries role. Size sits on the lattice.
Regular·Default for navigation and controls
The ladder
- thinDisplay only — never a control
- lightLarge, quiet specimens only
- regularDefault for navigation and controls
- boldFunctional emphasis — links and status
- fillReserved for labelled Play / Pause controls
- duotoneRuled out — two-tone ornament, off-brand
Sizes
- 16pxsize-4Inline controls · search, links, mediaverified in use
- 20pxsize-5Dense dismiss control · mobile Railverified in use
- 24pxsize-6Navigation target · Header menuverified in use
- 32pxsize-8Feature and empty statesreserved
The rules
- Must
Use regular weight for navigation and controls and bold for functional emphasis (links, status). Fill is reserved for labelled Play / Pause controls; thin and light only for large, quiet specimens.
- Must not
Use the duotone weight.
Extension
- Must
Size icons on the 4px base:
size-4(16px) inline,size-5(20px) for dense dismiss controls,size-6(24px) for navigation targets.
Usage
Legible, and accountable.
Choose the role, then make the glyph accountable.
context
role
accessible name
icon ink
surface
Assistive transcript
Control announced as "Search".
Choose
MagnifyingGlass · search
Size
20px · regular
Name
aria-label="Search"
Verify
--foreground on --background · 18.13:1
The rules
- Must
Give an icon-only control an
aria-labelthat names the action. When visible text already names it, or the glyph is decorative, set the iconaria-hidden.Extension
- Must
Let icons inherit colour from their context (
currentColor) rather than carrying a colour of their own.--foreground--muted-foreground--text-accentExtension - Must
Verify every meaningful glyph against its ground at the WCAG 3:1 non-text contrast bar.
--background--surface
Choose the role. Size for context. Name the action. Verify the contrast. Then let the icon settle into the component around it.
Continue to components