<Stepper activeStep={1}>
<StepperItem step={0}>
<StepperTrigger>
<Check class="size-4" />
</StepperTrigger>
<div>
<StepperTitle>Account</StepperTitle>
<StepperDescription>Create your account</StepperDescription>
</div>
</StepperItem>
<StepperSeparator />
<StepperItem step={1}>
<StepperTrigger>2</StepperTrigger>
<div>
<StepperTitle>Profile</StepperTitle>
<StepperDescription>Set up your profile</StepperDescription>
</div>
</StepperItem>
<StepperSeparator />
<StepperItem step={2}>
<StepperTrigger>3</StepperTrigger>
<div>
<StepperTitle>Complete</StepperTitle>
<StepperDescription>Review and finish</StepperDescription>
</div>
</StepperItem>
</Stepper>Installation
pnpm install @vds-testing/react @vds-testing/stylespnpm install @vds-testing/elements @vds-testing/stylesSee Installation for CSS setup.
Usage
React:
import {
Stepper,
StepperItem,
StepperTrigger,
StepperTitle,
StepperDescription,
StepperSeparator,
} from "@vds-testing/react"<Stepper activeStep={0}>
<StepperItem step={0}>
<StepperTrigger>1</StepperTrigger>
<StepperTitle>Step One</StepperTitle>
</StepperItem>
<StepperSeparator />
<StepperItem step={1}>
<StepperTrigger>2</StepperTrigger>
<StepperTitle>Step Two</StepperTitle>
</StepperItem>
</Stepper>Web Components:
<script type="module">
import "@vds-testing/elements";
</script>
<vds-stepper active-step="0">
<vds-stepper-item step="0">
<vds-stepper-trigger>1</vds-stepper-trigger>
<vds-stepper-title>Step One</vds-stepper-title>
</vds-stepper-item>
<vds-stepper-separator></vds-stepper-separator>
<vds-stepper-item step="1">
<vds-stepper-trigger>2</vds-stepper-trigger>
<vds-stepper-title>Step Two</vds-stepper-title>
</vds-stepper-item>
</vds-stepper>Examples
Simple stepper
<Stepper activeStep={0}>
<StepperItem step={0}>
<StepperTrigger>1</StepperTrigger>
<StepperTitle>Details</StepperTitle>
</StepperItem>
<StepperSeparator />
<StepperItem step={1}>
<StepperTrigger>2</StepperTrigger>
<StepperTitle>Payment</StepperTitle>
</StepperItem>
<StepperSeparator />
<StepperItem step={2}>
<StepperTrigger>3</StepperTrigger>
<StepperTitle>Confirm</StepperTitle>
</StepperItem>
</Stepper>Simple stepper vertical
Horizontal step row with labels below each indicator (instead of to the right). Separators stay horizontal.
<Stepper variant="simple" activeStep={1}>
<StepperItem step={0}>
<StepperTrigger>1</StepperTrigger>
<StepperTitle>Details</StepperTitle>
</StepperItem>
<StepperSeparator />
<StepperItem step={1}>
<StepperTrigger>2</StepperTrigger>
<StepperTitle>Payment</StepperTitle>
</StepperItem>
<StepperSeparator />
<StepperItem step={2}>
<StepperTrigger>3</StepperTrigger>
<StepperTitle>Confirm</StepperTitle>
</StepperItem>
</Stepper>Vertical orientation
<Stepper orientation="vertical" activeStep={1}>
<StepperItem step={0}>
<StepperTrigger>
<Check class="size-4" />
</StepperTrigger>
<div>
<StepperTitle>Create account</StepperTitle>
<StepperDescription>Enter your email and password</StepperDescription>
</div>
</StepperItem>
<StepperSeparator />
<StepperItem step={1}>
<StepperTrigger>2</StepperTrigger>
<div>
<StepperTitle>Verify email</StepperTitle>
<StepperDescription>Check your inbox</StepperDescription>
</div>
</StepperItem>
<StepperSeparator />
<StepperItem step={2}>
<StepperTrigger>3</StepperTrigger>
<div>
<StepperTitle>Complete setup</StepperTitle>
<StepperDescription>Add your profile</StepperDescription>
</div>
</StepperItem>
</Stepper>Completed steps with checkmark
Show a checkmark icon for completed steps.
<Stepper activeStep={2}>
<StepperItem step={0}>
<StepperTrigger>
<Check class="size-4" />
</StepperTrigger>
<StepperTitle>Cart</StepperTitle>
</StepperItem>
<StepperSeparator />
<StepperItem step={1}>
<StepperTrigger>
<Check class="size-4" />
</StepperTrigger>
<StepperTitle>Shipping</StepperTitle>
</StepperItem>
<StepperSeparator />
<StepperItem step={2}>
<StepperTrigger>
<CreditCard class="size-4" />
</StepperTrigger>
<StepperTitle>Payment</StepperTitle>
</StepperItem>
<StepperSeparator />
<StepperItem step={3}>
<StepperTrigger>4</StepperTrigger>
<StepperTitle>Confirm</StepperTitle>
</StepperItem>
</Stepper>Vertical with icons and descriptions
A complete vertical stepper with icons and detailed descriptions.
<Stepper orientation="vertical" activeStep={1}>
<StepperItem step={0}>
<StepperTrigger>
<Check class="size-4" />
</StepperTrigger>
<div>
<StepperTitle>Create your account</StepperTitle>
<StepperDescription>Sign up with your email address and create a secure password.</StepperDescription>
</div>
</StepperItem>
<StepperSeparator />
<StepperItem step={1}>
<StepperTrigger>
<Shield class="size-4" />
</StepperTrigger>
<div>
<StepperTitle>Verify your identity</StepperTitle>
<StepperDescription>Complete two-factor authentication for enhanced security.</StepperDescription>
</div>
</StepperItem>
<StepperSeparator />
<StepperItem step={2}>
<StepperTrigger>
<Package class="size-4" />
</StepperTrigger>
<div>
<StepperTitle>Choose your plan</StepperTitle>
<StepperDescription>Select a subscription that fits your needs.</StepperDescription>
</div>
</StepperItem>
</Stepper>Props
Stepper
| Prop | Type | Default | Description |
|---|---|---|---|
| orientation | “horizontal” | “vertical” | “horizontal” | Layout direction |
| variant | “default” | “simple” | “default” | simple keeps a horizontal row with labels below each indicator |
| activeStep | number | 0 | Current active step (0-indexed) |
| class / className | string | - | Additional CSS classes |
Active and completed indicators use --color-brand. Titles use vds-paragraph-strong (black when active, muted gray otherwise); descriptions and indicators use vds-paragraph-s. Triggers use focus-shape.
StepperItem
| Prop | Type | Default | Description |
|---|---|---|---|
| step | number | required | Step index (0-indexed) |
| class / className | string | - | Additional CSS classes |
StepperTrigger
Renders as a button.
| Prop | Type | Default | Description |
|---|---|---|---|
| class / className | string | - | Additional CSS classes |
StepperTitle, StepperDescription
Style components for step labels (vds-paragraph-strong / vds-paragraph-s).
StepperSeparator
Visual connector between steps. Place between StepperItem components. Always light gray; adapts to orientation (horizontal for simple and default horizontal; vertical when orientation="vertical").