Iconography

The system uses Phosphor Icons as its sole icon library. All icons are sourced from @phosphor-icons/react, which is already installed. No other icon packages should be introduced.

Overview

Phosphor is a flexible icon family with over 1,000 icons available in six weights. Icons are tree-shaken by default, only the icons you import are bundled.

Install

npm install @phosphor-icons/react

Usage

Import icons by name from the package, then render them as React components. Use Tailwind's size-* utility to control dimensions, never set width or height directly.

Import pattern

import { MagnifyingGlass, X, Check } from "@phosphor-icons/react"

<MagnifyingGlass className="size-4" />
<X className="size-4" />
<Check className="size-4" />

Size conventions

ClassSizeUse when
size-3.514pxCompact / inline with small text
size-416pxStandard UI, buttons, nav, labels
size-520pxEmphasis, empty states, hero spots

Styles

Phosphor ships six weights: Regular, Bold, Duotone, Fill, Light, and Thin. This system uses Regular exclusively, the default when you import directly from @phosphor-icons/react. Do not introduce other weights without a deliberate design decision.

Regular

Bold

Light

Thin

Fill

Duotone

System Icons

All icons currently in use across registry components and documentation.

MagnifyingGlass

Search trigger

CaretRight

Breadcrumb separator

ArrowLeft

Prev page nav

ArrowRight

Next page nav

ArrowUpRight

External link CTA

List

Mobile menu open

X

Close / dismiss

Moon

Dark mode toggle

Sun

Light mode toggle

Copy

Copy to clipboard

Check

Copy confirmed

CheckCircle

Do list items

XCircle

Don't list items

Warning

Alert / caution

Upload

File upload

Users

Empty state, teams

Envelope

Email input type

Lock

Password input type

Eye

Show password

EyeSlash

Hide password

Hash

Number input type

Link

URL input type

TextT

Text input type