# Progress

> Determinate or indeterminate accent bar on a tinted track.

- Group: Feedback
- Status: stable
- Aliases: progress-bar
- HTML page: https://design.ipmnx.com/components/progress/
- Spec: https://design.ipmnx.com/design/#nx-progress

## Preview

**68%**

```html
<div class="nx-progress" role="progressbar" aria-label="Upload"
    aria-valuenow="68" aria-valuemin="0" aria-valuemax="100">
  <div class="nx-progress__bar" style="width:68%"></div>
</div>
```

```tsx
<NxProgress value={68} label="Upload" />
```

## API

### React props (NxKit)

| Prop | Type | Default | Required | Description |
| --- | --- | --- | --- | --- |
| `value` | `number` | `0` |   | 0-100, ignored when indeterminate. |
| `label` | `string` | `undefined` |   | Required accessible name. NxProgress dev-warns when absent. |
| `indeterminate` | `boolean` | `false` |   | Animated unknown-duration state (reduced-motion fallback: static 40% bar). |

### Classes

| Class | Description |
| --- | --- |
| `.nx-progress` | Track, accent-100 bg, full radius |
| `.nx-progress__bar` | Accent fill bar |
| `.nx-progress--indeterminate` | Animated sweep, respects prefers-reduced-motion |

## States

### indeterminate

```html
<div class="nx-progress nx-progress--indeterminate" role="progressbar" aria-label="Loading"><div class="nx-progress__bar"></div></div>
```

## Accessibility

- role="progressbar" always needs an accessible name via aria-label/aria-labelledby. NxProgress dev-warns in non-production when label is missing.
- Indeterminate omits aria-valuenow (unknown value); reduced-motion shows a static partial bar instead of the sweep animation.

## Do / Don't

- Do: Always pass a label describing what's loading.
- Don't set aria-valuenow on an indeterminate bar.

## Related

- [Skeleton](https://design.ipmnx.com/components/skeleton.md)
- [Spinner](https://design.ipmnx.com/components/spinner.md)

---

Source: registry.js (NX Design System)
