Stepper
Multi-step progress indicator for checkout, booking, and onboarding flows. Booking.com / Klook pattern. Horizontal (default) for wide surfaces; vertical for narrow columns. Completed steps show a checkmark and are click-back navigable by default; upcoming steps are unclickable unless canNavigateForward is enabled.
Your details
Add extras
Payment
Confirmation
Vertical orientation
Pass orientation="vertical" for stacked layouts — better in narrow columns or long-form onboarding.
Create account
Email + password
Profile
Name, phone, preferences
Verify email
Check your inbox
Welcome
You're all set
Per-step description
Add description to any step for a muted-color secondary line under the label.
Create account
Email + password
Profile
Name, phone, preferences
Verify email
Check your inbox
Welcome
You're all set
Free navigation
By default users can navigate back (click completed steps) but not skip ahead (Booking.com pattern). Pass canNavigateForward to allow clicking upcoming steps — useful for wizards where every step is optional / preview-able.
Your details
Add extras
Payment
Confirmation
Usage notes
- — Presentational and controlled: parent owns
currentStepand swaps content based on it. Component only draws the indicator. - — Three states: completed (checkmark, brand-primary fill), current (brand-primary ring, number), upcoming (muted border + number).
- — Completed steps render as
<button>whenonStepClickis provided; the current + upcoming steps are static<span>so they can't accidentally be tabbed to. - — Current step carries
aria-current="step";every marker has a descriptivearia-labelincluding state (completed / current / upcoming). - — Prerequisite for the BookingForm workstream (audit #32) — checkout will drive the steps.