Skip to main content

Icon

Interactive

See Icon in Storybook for every variant, with live controls.

The only sanctioned icon source in Eidos. Wraps Lucide, addressed by kebab-case name.

import { Icon } from "@kairosis/eidos";

<Icon name="git-branch" size={16} />;

Props

PropTypeDefaultDescription
nameIconNameRequired. Lucide name, kebab-case
sizenumber16Square, in px
strokeWidthnumber1.75
colorstringDefaults to currentColor

Guidelines

  • Use Lucide's current names. Several were renamed: circle-check (not check-circle-2), triangle-alert (not alert-triangle), circle-alert (not alert-circle), house (not home). An unknown name renders nothing and warns in development.
  • Icons are aria-hidden — they're decorative. When an icon is a control's only content, label the control (see IconButton).
  • Colour is inherited: set color on the parent and the glyph follows. Only pass color to break from the text colour.
  • 16px alongside text; 16–18px inside a 36px standalone hit target.
  • Names are resolved from Lucide's map at runtime, so the whole set is available without extra imports — the trade-off is that bundlers can't tree-shake unused glyphs.