Stepper

A multi-step navigation component that guides users through a sequence of steps or actions.

Example

Usage

Installation

Install following dependencies:

npm install @radix-ui/react-slot react-aria-components tw-animate-css tailwindcss-react-aria-components class-variance-authority lucide-react clsx tailwind-merge motion

Add cn helper using clsx and twMerge for conditional class merging in Tailwind components.

lib/utils.ts

Copy and paste the following code into your project.

components/ui/core/stepper.tsx
npx libravelui@latest add stepper

Anatomy

import { Stepper } from "@/components/ui/core/stepper";

import {
  StepperRoot,
  StepperItem,
  StepperTrigger,
  StepperIndicator,
  StepperTitle,
  StepperDescription,
  StepperSeparator,
  StepperContent,
  StepperItems,
} from "@/components/ui/core/stepper";
<Stepper steps={steps} activeStep={step} onStepChange={setStep} />

/* Or */

<StepperRoot>
  <StepperItems>
    <StepperItem>
      <StepperTrigger>
        <StepperIndicator />
        <div>
          <StepperTitle>{title}</StepperTitle>
          <StepperDescription>{description}</StepperDescription>
        </div>
      </StepperTrigger>

      <StepperSeparator />
    </StepperItem>
  </StepperItems>
</StepperRoot>

Another Examples

Vertical

You can display the stepper vertically instead of horizontally. This layout is useful when you have limited horizontal space or want to create a more structured, top-to-bottom flow for multi-step processes.

Usage

Animated

Add smooth animations between steps to create a more engaging and dynamic user experience. Transitions help users understand progress changes and make navigation between steps feel more natural.

Usage

Props

Loading types…

Accessible React component library to copy, customize, and own your UI. Built for Next.js, Vite, and Laravel.

Crafted by dervyon. Peep the Source Code on GitHub.

Hosted on Vercel. The source code's got the MIT license.

2025 - 2026 · LibravelUI

Starter Kits

Templates

    Coming Soon

Labs