Skip to Content
✨ Just dropped my UI Library — still cooking up some magic! Stay tuned & maybe… hire me  or sponsor me 😉 
DocumentationStepper

Stepper

A visual progress indicator that shows users their current position in a multi-step process. Features responsive design, multiple sizes, vertical/horizontal layouts, and smooth animations.

Install Dependencies

npx
quickcode-ui add Stepper

Horizontal Life Journey Stepper

Horizontal Life Journey Stepper

3
4
5
6
7
8
9
10

Start School

Realize nap time was peak life

Vertical Project Timeline

Vertical Project Timeline

Project Kickoff

Gather requirements and set expectations

Research Phase

Market analysis and competitor research

Design & Wireframes

Create user interface mockups

Development Sprint

Build core features and functionality

5

Testing & QA

Bug fixes and quality assurance

6

Client Review

Present demo and gather feedback

7

Revisions

Implement requested changes

8

Performance Optimization

Speed and efficiency improvements

9

Launch Preparation

Final checks and deployment setup

10

Go Live

Release to production environment

Props

PropTypeDefaultDescription
stepsStepperStep[]-Array of step objects with id, title, and description
currentStepnumber-Zero-based index of the current active step
classNamestring-Additional CSS classes
showLabelsbooleantrueWhether to show step titles and descriptions
size"sm" | "md" | "lg""md"Size variant affecting circle and text sizes
verticalbooleanfalseWhether to display steps vertically

StepperStep Interface

PropertyTypeRequiredDescription
idstringYesUnique identifier for the step
titlestringYesDisplay title for the step
descriptionstringNoOptional description text

Features

  • Dual Layouts: Horizontal layout for desktop with connecting lines, vertical layout for timelines and detailed processes
  • Responsive Design: Mobile-optimized horizontal layout with centered steps and current step details
  • Progress Visualization: Completed steps show checkmarks, current step is highlighted, future steps are muted
  • Multiple Sizes: Small, medium, and large variants for different use cases
  • Smooth Animations: Transitions between steps with scale and color animations
  • Accessible: Proper contrast ratios and semantic structure for screen readers
  • Flexible Content: Support for step titles and optional descriptions
  • Dark Mode Ready: Seamless integration with light and dark themes

Perfect for onboarding flows, checkout processes, form wizards, project timelines, and any multi-step user journey.

Last updated on