# Coffee — Recommended icon packs

The Coffee theme renders icons through the CMS sprite system only
(`<svg><use href="/icons/<pack>.svg#<name>"/></svg>`). It relies on two
bundled packs, declared in `plugin.mod` `required_icon_packs`:

| Pack           | Used for |
|----------------|----------|
| `lucide`       | UI glyphs in builtin overrides (arrows, chevrons, check, map-pin, navigation, star, play, download, x). Bundled with the CMS — no install needed. |
| `simple-icons` | Brand marks in author-bio-hero and social-links (x, linkedin, github, instagram, facebook). Bundled with the CMS — no install needed. |

Both packs ship with the CMS, so the theme renders with no manual setup.

## If the loader does not auto-install

The `required_icon_packs` field is forward-declared. Until the loader honors
it, confirm the packs are present:

1. Open `/admin/icons`.
2. Confirm **Lucide** and **Simple Icons** are installed and enabled (both are
   bundled defaults).
3. No downloads are required.

Block content stores icon references as `"pack:name"` strings (e.g.
`"lucide:coffee"`, `"simple-icons:instagram"`). The theme never inlines SVG
paths.
