Skip to content
Design System
GitHub

Meter

v0.17.4

A level within a known range, neutral until it crosses a threshold; inline for table cells.

Battery72 %
Battery9 %
Storage86 %
Storage97 %

Meter levels

Install
npx shadcn add @syncrobotic/meter

Also installs: @syncrobotic/cn

Overview

When to use

  • Battery, storage, signal strength, CPU.
  • Inline in a table cell, or above a value in a card.

Use something else

  • Work that is under way and will finish: Progress.

More examples

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

72 %
12 %

Meter inline

Motor temperature48 °C
Motor temperature68 °C
Motor temperature81 °C

Meter higher is worse

Recording storage412 GB

Meter storage

Battery72 %
Signal54 %
Storage used81 %
CPU36 %

Meter grid

Usage rules

  • For a level in a known range (battery, storage). For work under way, use Progress.
  • Neutral while normal; warning past low, danger past critical; the value is always written. A battery takes only low (15 %): a low battery needs attention, it is not a failure, so it turns warning and never danger. Danger is for a level that breaks something, like full storage.
  • inline in table cells; the label is still read by screen readers.

Changelog

  • 0.17.42026-11-21No unused React import, so the file compiles in projects with noUnusedLocals.
  • 0.17.32026-11-19Tracks and quiet shapes use the new --track token, so they read in dark mode (1.5:1 on their surface; they were near invisible).
  • 0.8.02026-11-17First release.

How to upgrade