# Recommended icons — Pastel Dream

This theme renders icons through the CMS sprite system only
(`<svg><use href="/icons/<pack>.svg#<name>"/></svg>`). It declares its packs in
`plugin.mod` `required_icon_packs`. Until the loader auto-installs declared
packs, install them by hand before activation.

## Required packs

| Pack | Used by |
|------|---------|
| **lucide** (bundled) | Navigation, hero and CTA arrows, contact and hours icons, timeline markers, gallery and card chrome. This is the primary pack and is bundled with the CMS. |
| **simple-icons** (bundled) | Brand marks in the footer and social-links override (Instagram, Facebook, etc.). |

Both packs ship bundled with the CMS, so in most instances nothing needs to be
installed. If a fresh instance is missing one:

1. Open `/admin/icons`.
2. Find **Lucide** and **Simple Icons** and click **Install** / **Enable**.
3. Save. Templates that reference `lucide:*` and `simple-icons:*` now resolve.

## Notes

- Block content stores icon references as `"pack:name"` strings and the
  templates split them at render time. Do not inline raw SVG.
- If an icon name is missing from a pack, the sprite `<use>` simply renders
  nothing rather than breaking layout. Prefer the bundled Lucide names already
  used across the overrides (`arrow-right`, `map-pin`, `navigation`,
  `croissant`, `menu`, `x`, `chevron-down`).
