Skip to content
Tetrifox

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.

01

List

Header · open navigation

24px · regular · aria-label on control

02

MagnifyingGlass

Header · search

16px · regular · visible label

03

ArrowRight

Button · continue

16px · bold · label carries meaning

04

ArrowUpRight

Footer · external link

16px · regular · destination is explicit

One vocabulary, read through the context that gives it meaning.

Phosphor set

One committed vocabulary.

A Phosphor glyph identifies an action, state, or direction.

Extension

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

09

Verified 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

09

Approved 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/react only, 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

Contract passes18.13:1non-text AA pass

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-label that names the action. When visible text already names it, or the glyph is decorative, set the icon aria-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