Skip to content
RivetUI

Stepper

Shows progress through a sequence and lets users return to available steps.

@rivetui/stepper

Preview

Explore each composition interactively, then open its code in the same context.

Default

Communicate the current position while keeping completed steps available.

Vertical

Use a vertical sequence when labels need more room or the available width is constrained.

Disabled step

Keep unavailable steps visible while preventing interaction until their prerequisite is complete.

Registry

Installation

Add the component source and its declared dependencies with the shadcn CLI.

Install component
bunx --bun shadcn@latest add @rivetui/stepper
Inspect registry item

Public interface

API reference

Component-specific props are listed here. Native element and Base UI props continue to pass through.

Stepper

PropTypeDefault
valuenumber—
defaultValuenumber1
onValueChange(value: number) => void—
orientation"horizontal" | "vertical""horizontal"
disabledbooleanfalse

StepperItem

PropTypeDefault
stepnumberrequired
disabledbooleanfalse
Rivet UI / StepperComponents engineered, not decorated.