components / progress

progress.

linear progress bar — square, three track heights, bare or outlined. determinate from value/max, or an indeterminate sweep for unknown durations. honors prefers-reduced-motion.

today's focus0%
sessions5 of 8
syncing
installation
bunx @justin06lee/chrome@latest add progress
props
nametypedefaultdescription
valuenumber0current amount; ignored when indeterminate.
maxnumber100upper bound for value.
indeterminatebooleanfalseunknown-duration state: a sliver sweeps the track and no value is reported to assistive tech.
size'sm' | 'md' | 'lg''md'track height: 2px, 4px, 8px.
accentstring'#fff'css color for the filled bar.
labelReactNode-caption above the track, set in the mono group-label style.
showValuebooleanfalseshow the percentage opposite the label.
borderedbooleanfalseoutline the track instead of tinting it. only sensible at size 'lg'.
valueTextstring-custom value text, e.g. "3 of 8". overrides the percentage and sets aria-valuetext.
ariaLabelstring-
classNamestring-