Progress
Determinate progress with semantic variants, sizes, and label/value composition — plus a built-in indeterminate sweep for unknown waits.
Installation#
pnpm dlx shadcn@latest add @davinciui/progressUsage#
Composition: Progress renders its track automatically — nest ProgressLabel and ProgressValue inside for the header row. Pass value={null} when progress can't be measured.
API Reference#
| Prop | Type | Default |
|---|---|---|
valueCurrent value. Null sweeps an indeterminate bar. | number | null | 0 |
minMinimum value. | number | 0 |
maxMaximum value. | number | 100 |
variantIndicator treatment. | "primary" | "default" | "success" | "warning" | "destructive" | "primary" |
sizeTrack height from hairline to hero. | "xs" | "sm" | "default" | "lg" | "default" |
format / locale / getAriaValueTextValue formatting and screen-reader text via Base UI. | Intl + fn | — |
ProgressLabel / ValueHeader row parts composed as children. | Component | — |
ProgressTrack / IndicatorExported for fully custom layouts. | Component | — |
classNameAdditional CSS classes. | string | — |
Accessibility#
Base UI renders a progressbar with min, max, and now from value, min, and max, linking ProgressLabel and ProgressValue; format and getAriaValueText customize spoken output. A null value produces indeterminate semantics without a numeric now.
Motion#
Determinate fills transition width over 300ms ease-out, and a null value runs a 1.2s infinite horizontal sweep. motion-reduce utilities disable both the width transition and the keyframe animation, and no timing props are exposed.
View source
Keep in mind
Need a custom component?
I build bespoke UI components & websites tailored to your brand.

