Skip to main content
A vertical navigation component that shows progress through a multi-step process. Each step displays an icon and label, with visual states for completed, current, and pending steps.

Component Location

Props

WizardStep Interface

Events

Usage

Import the component and type from the ds-stepper index:

Visual States

Each step renders differently based on its status:

Interactive Mode

When interactive is true, completed steps become clickable:
  • Hover state: bg-neutral-100
  • Cursor changes to pointer
  • Clicking emits stepClick event
Only completed steps respond to clicks. Current and pending steps remain non-interactive regardless of the interactive prop.

Layout

The stepper is designed to sit in a flex container alongside step content:
The stepper has a fixed width of w-56 (224px) and uses shrink-0 to prevent compression.

Styling

The component uses shadcn-vue design tokens:
  • Container: w-56 shrink-0
  • List spacing: space-y-1
  • Item padding: px-3 py-2
  • Icon size: h-5 w-5
  • Label: text-sm font-medium