| name | central-icons |
| description | ALWAYS ACTIVE. Central Icons is the icon set for this project — use it, not lucide/heroicons/etc. Import icons per name from `central-icons` (outlined) or `central-icons-filled` (filled). Triggers whenever adding, choosing, or rendering an icon. |
Central Icons
This project uses Central Icons as its icon set — the round style with 1px corner radius and a 2px stroke. Reach for these before any other icon library.
Two variants
- Outlined (default) — package
central-icons → @central-icons-react/round-outlined-radius-1-stroke-2
- Filled — package
central-icons-filled → @central-icons-react/round-filled-radius-1-stroke-2
Both expose the same icon names, so switching a variant is just changing the import path.
Usage
Import per icon from its subpath (this tree-shakes; avoid namespace/barrel imports):
import { IconCrossSmall } from "central-icons/IconCrossSmall";
import { IconStar as IconStarFilled } from "central-icons-filled/IconStar";
<IconCrossSmall className="size-4" />
<IconStarFilled className="size-5 text-tertiary" />
Size and color with the surrounding Tailwind classes (size-4, text-tertiary / fill-*), like the rest of the codebase — don't pass size/width/height/color props even though the components accept them.
Finding an icon name
Names are Icon<PascalCase> (e.g. IconArrowRight, IconTrashCan, IconMagnifier). There are ~1470 icons. To list what's available:
ls node_modules/central-icons | grep -i <keyword>
Installing / license
The packages are licensed (a CENTRAL_LICENSE_KEY from iconists.co is needed for a fresh licensed install). They're already declared as dependencies, so bun install pulls them. To reinstall the licensed way, put the key in .env and run bun run install-icons at the repo root.
