Skip to content

Iconography

Icons provide visual cues, reduce cognitive load, and support text content. Our system is built on a consistent grid and stroke style.

Size tokens
TokenSizeUsage
--icon-xs12pxBadges, inline icons
--icon-sm16pxUI controls, links
--icon-md20pxNavigation, buttons
--icon-lg24pxFeature icons
--icon-xl32pxHero sections
--icon-2xl48pxEmpty states
  • Stroke width: 2px for most icons, 1.5px for smaller sizes (12–14px)
  • Corner radius: 2px — slightly rounded, not circular
  • Fill: outline style by default, filled variant for active states
  • Alignment: centered optically, not geometrically
  • Always pair icons with text labels in navigation and buttons
  • Same icon size for sibling elements
  • Don’t mix filled and outline styles in the same context
  • Icons should be decorative or descriptive — never the sole indicator of meaning
  • Use currentColor for icon fill/stroke to inherit text color