# Progress

Determinate or indeterminate progress, measured on a hairline track.

- Family: Status, imported from `mizu-ui` or `mizu-ui/status`
- Docs: https://mizu.user64bit.world/components/progress
- Source: https://github.com/0xuser64bit/mizu/blob/main/packages/mizu/src/status/Feedback.tsx

## Usage

```tsx
import { Progress } from "mizu-ui";

export function Example() {
  return (
    <div style={{ display: "grid", gap: 24 }}>
      <Progress label="Processing artwork" value={42} />
      <Progress label="Waiting for a worker" />
    </div>
  );
}
```

## Copy it with the shadcn CLI

```sh
npx shadcn@latest init 0xuser64bit/mizu/preset # once, where there is no components.json
npx shadcn@latest add 0xuser64bit/mizu/progress
```

## Props

- `value`: `number | undefined`. Omit for indeterminate progress.
- `max`: `number` (default `100`). Completion value.
- `label / showValue`: `string / boolean`. Accessible label and visible percentage.

## Accessibility

Native progress announces its value. Omitted value represents an unknown completion amount.

## Motion

CSS transitions explain state changes. Reduced motion removes travel.