Context
The product needs a UI icon library for the admin panel, operator panel, and sales-app surfaces. Choice affects visual consistency, developer ergonomics, and the premium aesthetic we're building for property sales.
Decision
Phosphor Icons — use the thin / light weights for the premium property-SaaS look across all surfaces.
Alternatives Considered
- Lucide — MIT, most common in React stacks, single weight. Rejected: single weight limits expressiveness; Phosphor covers the same set plus more.
- Heroicons — Tailwind team, very clean. Rejected: ~300 icons is insufficient for a full admin + operator surface.
- Custom SVGs — full control. Rejected: maintenance cost is too high at this stage.
Consequences
- Phosphor is MIT licensed, tree-shakable, works with React + any framework.
- Multiple weights available: use
thin/lightin property-facing views (clean, premium),regular/boldin admin alerts and CTAs. - Tech team installs
@phosphor-icons/react(orphosphor-iconsfor vanilla). Pin major version at setup to avoid unintentional icon changes.
Revisit trigger
If Phosphor is deprecated or drops React support.