# Stepper (Andromeda Pro)

Stepper is a component of the Premium Andromeda Pro design system from AI Canvas (https://aicanvas.me). Index of every system, component and install setup: https://aicanvas.me/llms.txt

Shows a run of steps in order, marking each one done, running or still to come.

- Design system: [Andromeda Pro](https://aicanvas.me/design-systems/andromeda-pro.md)
- License: Premium (proprietary)
- Install slug: `andromeda-pro-stepper`
- Page: https://aicanvas.me/design-systems/andromeda-pro/stepper

## Install

```bash
npx shadcn@latest add @aicanvas/andromeda-pro-stepper
```

Requires Premium. Without a Premium token the command writes a placeholder (a `PremiumLocked` notice) instead of the component.

Every Andromeda Pro component at once: `npx shadcn@latest add @aicanvas/andromeda-pro`.

Token setup: the Install section of https://aicanvas.me/llms.txt.

## Use it

It installs to `components/aicanvas/andromeda-pro/components/Stepper.tsx` (under `src/` if your project has one). With the usual `@/` alias:

```tsx
import { Stepper } from '@/components/aicanvas/andromeda-pro/components/Stepper'
```

## Example

```tsx
import { Stepper, StepperDescription, StepperItem, StepperMeta, StepperTitle } from '@/components/aicanvas/andromeda-pro/components/Stepper'

<Stepper activeStep={1} aria-label="Invoice delivery">
  <StepperItem>
    <StepperTitle>Invoice created</StepperTitle>
    <StepperDescription>Draft saved for review.</StepperDescription>
    <StepperMeta>09:30</StepperMeta>
  </StepperItem>
  <StepperItem>
    <StepperTitle>Invoice sent</StepperTitle>
    <StepperDescription>Waiting for payment.</StepperDescription>
    <StepperMeta>10:15</StepperMeta>
  </StepperItem>
</Stepper>
```

## Parts

Stepper is built from `Stepper` and `StepperItem`. Each part has its own props table below.

## Variants

- `state` on `StepperItem`: pending, active or complete

## Props

### Stepper

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `activeStep?` | `number` | `0` | The index of the step in progress. Steps before it are complete, steps after it pending; -1 leaves every step pending and the step count or more marks every step complete. |
| `labels?` | `{pending: string, active: string, complete: string}` |  | The state words read to assistive tech beside each title; defaults "Pending", "In progress", "Complete". |
| `aria-label?` | `string` |  | Names the run for assistive tech (or use aria-labelledby). |

### StepperItem

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `state?` | `'pending'\|'active'\|'complete'` |  | Overrides the state the root's `activeStep` gives this step. |

## Remix prompt

Only when the user wants Stepper rebuilt from scratch instead of installed: the public part of its remix prompt is in the Remix panel at https://aicanvas.me/design-systems/andromeda-pro/stepper.

## More Andromeda Pro components

- [Stat Tile](https://aicanvas.me/design-systems/andromeda-pro/stat-tile.md)
- [Strength Meter](https://aicanvas.me/design-systems/andromeda-pro/strength-meter.md)
- [Suggestion](https://aicanvas.me/design-systems/andromeda-pro/suggestion.md)
- [Tabs](https://aicanvas.me/design-systems/andromeda-pro/tabs.md)
- [Tag](https://aicanvas.me/design-systems/andromeda-pro/tag.md)
