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

Command Palette

Search for a command to run...

Docs
Progress Tracker

Progress Tracker

A progress tracking component with three variants - segmented bars, continuous progress bar, and dot indicators. Shows step X of Y labels.

Installation

Usage

import { ProgressTracker } from "@/components/ruixen/progress-tracker";
<ProgressTracker
  totalSteps={5}
  currentStep={3}
  onStepChange={setStep}
  variant="segments"
/>

Examples

Segmented Progress

<ProgressTracker totalSteps={5} currentStep={3} variant="segments" />

Continuous Bar

<ProgressTracker totalSteps={6} currentStep={2} variant="bar" />

Dot Indicators

<ProgressTracker totalSteps={7} currentStep={4} variant="dots" />

Label Position

// Label on top
<ProgressTracker
  totalSteps={4}
  currentStep={2}
  labelPosition="top"
/>
 
// Label on bottom (default)
<ProgressTracker
  totalSteps={4}
  currentStep={2}
  labelPosition="bottom"
/>
 
// Without label
<ProgressTracker
  totalSteps={5}
  currentStep={3}
  showLabel={false}
/>

Props

ProgressTracker

PropTypeDefaultDescription
totalStepsnumberRequiredTotal number of steps
defaultStepnumber1Default active step
currentStepnumber-Controlled active step
onStepChange(step: number) => void-Callback when step changes
showLabelbooleantrueShow "Step X of Y" label
labelPosition"top" | "bottom""bottom"Label position
variant"bar" | "segments" | "dots""segments"Visual style variant