# Lucide

The vendored icon set: 1,745 icons served from the gem, rendered through poetry_icon with literal-name validation.

The default icon set: 1,745 Lucide icons vendored into the gem at a pinned upstream commit (`Poetry::Lucide.vendored_commit`) and sanitized at vendor time, so rendering never parses, never sanitizes, and never touches the network. Requiring the gem registers the set as `:lucide`; `poetry_icon(name: :"circle-check")` renders decorative (aria-hidden) by default, and `label:` makes an icon standalone (`role="img"` plus the accessible name). `poetry check` validates icon-name literals statically against the set; a dynamic miss raises with a did-you-mean in development and test and renders the configured fallback (`:"circle-question-mark"`) in production while `on_missing_icon` fires. The vendored Lucide icons remain under Lucide's ISC license - see `LICENSE-LUCIDE.txt`, which ships in the gem beside them.