Skip to content
Design System
GitHub

Progress

v0.17.3

Determinate progress; blue unless the value itself is a status.

Uploading video64 %
Installing firmware 2.4.118 %

Progress default

Install
npx shadcn add @syncrobotic/progress

Also installs: radix-ui, @syncrobotic/cn

Overview

A bar that fills as work completes. Blue means in progress.

When to use

  • Uploads, map processing, a mission's completion.

Use something else

  • Waiting with no measurable progress: Spinner.
  • Content still loading: Skeleton.
  • A level that is not work, like battery: Meter.

More examples

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

Map uploadDone
Route check45 %
FirmwareWaiting

Progress steps

Map upload40 %
Firmware update100 %

Progress tones

Inventory scan

Aisle 14 of 24 · about 6 min left

Progress in card

Usage rules

  • Blue: a process someone is waiting on, with an end. A level that stays (battery, storage, signal) is a Meter, not a Progress.
  • Success is neutral: a finished bar stays grey. Green is a confirmation that comes and goes (a toast), not a state.

Changelog

  • 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). A 0 % bar keeps an --input edge so a waiting bar still shows.
  • 0.17.22026-11-19tone="success" is neutral: a finished bar stays grey (green is a confirmation that comes and goes, not a state that stays).
  • 0.17.12026-11-19Documentation: a level that stays (battery, storage) is a Meter, not a Progress.

How to upgrade