A square or round surface behind one icon, in five surfaces and four sizes, with an optional status dot.
Icon tile default
Install
npx shadcn add @syncrobotic/icon-tile Also installs: class-variance-authority, radix-ui, @syncrobotic/cn
Overview
A tile that gives an icon a consistent surface and size, so icons in rows, cards and empty states line up.
When to use
- The media of a row or card.
- A status at a glance: a failed run, a warning.
- A feature or category heading.
Use something else
- A person: Avatar.
- A status next to text in a row: Status glyph or Status eyebrow.
More examples
States and real uses. Each example is also a Storybook story and a visual regression test.
Icon tile variants
Icon tile sizes
Icon tile circle
Icon tile status tones
Icon tile with dot
Icon tile text
Icon tile in a row
Icon tile feature
Icon tile as link
Usage rules
- Neutral by default. A tone only when the tile states a status.
- Tones info and success render neutral: a tile stays on screen, so it is a state, and a state is grey. Only warning and danger colour it.
- Never solid red: a solid danger tile stays on its tint, since solid red belongs to the emergency stop.
- Icons inside are 16, 20 or 24 px; the size prop sets them.
Changelog
- 0.17.22026-11-19IconTileDot defaults to neutral (it was green).
- 0.17.12026-11-19tone="info" is neutral, like success: a tile stays on screen, and blue is only for a process someone is waiting on. Solid warning takes the mode's ink, 4.5:1 or more in every theme (it was 2.2:1 in light high contrast; solid info was 2.5:1 in dark).
- 0.10.02026-11-18tone="success" is neutral on soft and solid tiles, and its status dot is the foreground colour.