Skip to content
Design System
GitHub

Icon tile

v0.17.2Beta

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

More examples

States and real uses. Each example is also a Storybook story and a visual regression test.

outline
muted
raised
soft
solid

Icon tile variants

sm
md
lg
xl

Icon tile sizes

Icon tile circle

Icon tile status tones

Icon tile with dot

7F+3

Icon tile text

Site maps12 files · Mei Lin

Icon tile in a row

Obstacle radarSees people and pallets 12 m ahead, day or night.

Icon tile feature

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.

How to upgrade