Foundations
Icon
Outline icons on a 24px grid with a 1.5px stroke and round caps; they paint with currentColor, so set the colour on the parent.
- Sizes: 16 inside small controls and badges, 20 in buttons, fields and navigation (the default), 24 for standalone icons.
- Colour: inherit
text-subtlefor neutral icons; status icons takeinfo,success,warningorcriticaland always sit beside a word. - Pass
labelonly when the icon stands alone and means something; decorative icons stay hidden from screen readers. - Use only names from
Icon.names. A missing glyph rendersplaceholder: ask for the icon to be added rather than drawing one inline.
When to use
Reinforce meaning next to text, or stand alone inside an IconButton.
Use something else
Status → Badge with an icon. Decoration → leave it out.
Do
- Use 16 in default controls, 14 in small ones, 20 only in large buttons and empty states.
- Pass
labelwhen the icon carries meaning on its own.
Don't
- Don't use icons from other libraries, emoji or unicode glyphs.
- Don't recolour icons outside the token palette.
Props
| Prop | Type |
|---|---|
name required | string |
size | 16 | 20 | 24 | number |
label | string |
Use
const { Icon } = window.Tessera;
const el = React.createElement(Icon, { /* props */ });