# Progress

How far a task has come, or that it is running.

Import from `@a31labs/rax/progress`.

## Usage

```tsx
<Progress label="Uploading" value={42} />
<Progress label="Steps" value={3} max={5} valueLabel="3 of 5" tone="ok" />
```

## Rules

Props: `value` (clamped to 0..`max`; `null` means indeterminate), `max` (default 100), `label`, `valueLabel` (replaces the default "NN%", e.g. "3 of 5" or "1.2 GB of 5 GB"), `tone` (`accent` default | `accent-2` | `ok` | `warn` | `danger`). Wraps Base UI Progress. Label above the bar on the left, value text on the right in ink-2 with tabular figures; `valueLabel` is also the `aria-valuetext`. Track 8px, surface-3, fully round, fill in the tone colour, grown through `transform: scaleX` and static under reduced motion. Indeterminate shows an opacity-pulsing bar and no value text.

Page: https://rax.a31.at/components/progress
