Design system/Components
Progress bar and steps
A progress bar shows a known amount: Library storage, seats, a file upload. Steps tell people where they are in a multi-step flow.
In codecomponents/controls.tsx (Progress)components/settings/settings-ui.tsxcomponents/uploader.tsx
Live example
Size and color
Altitude
5–6px · r 999pxBackground
var(--muted)Fill
var(--accent)Full: var(--red) · unlimited: var(--green-soft)Change
width 0.3s cubic-bezier(0.22, 1, 0.36, 1)Role
role=progressbar · aria-valuenow/min/max · aria-label- The number is always written next to the bar: “1.2 of 2 GB”; the bar alone isn't precise.
- Any value above zero fills at least 3 percent of the bar, so “a little used” doesn't look the same as “none”.
- An unknown amount doesn't get a bar; use a skeleton or a spinner.
Related pages