Ruixen Pro is now live.30+ premium components, templates, blocks, and lifetime updates.

Command Palette

Search for a command to run...

Docs
Wizard Stepper

Wizard Stepper

A full-featured wizard stepper with titles and descriptions. Perfect for multi-step forms, checkout flows, and onboarding sequences.

Installation

Usage

import {
  WizardStepper,
  WizardStepData,
} from "@/components/ruixen/wizard-stepper";
const steps: WizardStepData[] = [
  { id: 1, title: "Account", description: "Create your account" },
  { id: 2, title: "Profile", description: "Set up your profile" },
  { id: 3, title: "Preferences", description: "Customize settings" },
  { id: 4, title: "Complete", description: "Review and finish" },
];
 
<WizardStepper steps={steps} currentStep={1} onStepChange={setStep} />;

Examples

With Descriptions

const steps = [
  { id: 1, title: "Account", description: "Create your account" },
  { id: 2, title: "Profile", description: "Set up your profile" },
  { id: 3, title: "Complete", description: "Review and finish" },
];
 
<WizardStepper steps={steps} currentStep={1} />;

Vertical Layout

<WizardStepper steps={steps} currentStep={2} orientation="vertical" />

With Loading State

<WizardStepper steps={steps} currentStep={1} loading={isLoading} />

Simple Labels Only

const steps = [
  { id: 1, title: "Welcome" },
  { id: 2, title: "Setup" },
  { id: 3, title: "Done" },
];
 
<WizardStepper steps={steps} currentStep={0} />;

Props

WizardStepper

PropTypeDefaultDescription
stepsWizardStepData[]RequiredArray of step definitions
defaultStepnumber0Default active step index
currentStepnumber-Controlled active step
onStepChange(step: number) => void-Callback when step changes
loadingbooleanfalseShow loading spinner
orientation"horizontal" | "vertical""horizontal"Layout orientation

WizardStepData

PropertyTypeDescription
idstring | numberUnique identifier
titlestringStep title
descriptionstringOptional description