ProgressBar

A horizontal bar that indicates the progress of a task. Supports determinate values and an indeterminate loading state.

Basic

Prop	Type	Default	Description
`value`	`number`	—	Current progress value.
`max`	`number`	`100`	Maximum value.
`size`	`"sm" \| "md" \| "lg"`	`"md"`	Size preset for the bar height.
`color`	`"blue" \| "red" \| "green" \| "yellow" \| "purple" \| "neutral" \| string`	`"blue"`	Accent color.
`label`	`string`	—	Accessible label displayed above the bar.
`showValue`	`boolean`	`false`	Whether to display the current value as a percentage.
`indeterminate`	`boolean`	`false`	Shows an indeterminate animation instead of a fixed value.
`--mantle-bg`	`CSS variable`	`theme default`	Override the background color via style. e.g. style={{ "--mantle-bg": "#1a1a2e" }}
`--mantle-border`	`CSS variable`	`theme default`	Override the border color via style. Set to "transparent" to remove. e.g. style={{ "--mantle-border": "#e94560" }}
`--mantle-text`	`CSS variable`	`theme default`	Override the text color via style. e.g. style={{ "--mantle-text": "#ffffff" }}
`--mantle-ring`	`CSS variable`	`accent`	Override the focus ring color via style. e.g. style={{ "--mantle-ring": "#e94560" }}

value

number

Current progress value.

max100

number

Maximum value.

size"md"

"sm" | "md" | "lg"

Size preset for the bar height.

color"blue"

Accent color.

label

string

Accessible label displayed above the bar.

showValuefalse

boolean

Whether to display the current value as a percentage.

indeterminatefalse

boolean

Shows an indeterminate animation instead of a fixed value.

--mantle-bgtheme default

CSS variable

Override the background color via style. e.g. style={{ "--mantle-bg": "#1a1a2e" }}

--mantle-bordertheme default

CSS variable

Override the border color via style. Set to "transparent" to remove. e.g. style={{ "--mantle-border": "#e94560" }}

--mantle-texttheme default

CSS variable

Override the text color via style. e.g. style={{ "--mantle-text": "#ffffff" }}

--mantle-ringaccent

CSS variable

Override the focus ring color via style. e.g. style={{ "--mantle-ring": "#e94560" }}