# Earthen — icon packs

Earthen renders icons through the sprite system only
(`<svg><use href="/icons/<pack>.svg#<name>"/></svg>`, or the `::pack:name:size::`
shorthand in templates). It does **not** inline icon SVGs. The theme's botanical
line-art (fern, seed, root motifs) is decorative illustration, not icons, and is
drawn inline on purpose.

## Required pack

- **Lucide** — declared in `plugin.mod` `required_icon_packs = ["lucide"]`.
  Lucide ships bundled with the CMS, so no action is normally needed. If it is
  missing on your instance, open `/admin/icons`, install **Lucide**, and enable it.

Block schemas that expose an icon picker default to Lucide names, so the theme
renders correctly out of the box. When the loader begins honoring
`required_icon_packs`, Lucide will be installed automatically on activation.

## Optional

No other packs are required. If you add icons from another pack in block content,
install that pack via `/admin/icons` first, then reference it as `"<pack>:<name>"`
in the block's icon field.
