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
| Class | Size | Use when |
|---|---|---|
| size-3.5 | 14px | Compact / inline with small text |
| size-4 | 16px | Standard UI, buttons, nav, labels |
| size-5 | 20px | Emphasis, 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