Mikkel Manniche
Dansk English Deutsch

Navigation

Step indicator

Bars for each step with one tooltip that slides to the step you point at.

Adapted from Watermelon UI (MIT) and rewritten with keyboard support, labels and reduced motion.

Preview

Usage

step-indicator-demo.tsx
import { CreditCard, PackageCheck, ShoppingBag, Truck } from 'lucide-react'
import { useState } from 'react'
import { StepIndicator } from '@/components/step-indicator'

const steps = [
  { id: 'bag', label: 'Bag', icon: <ShoppingBag /> },
  { id: 'shipping', label: 'Shipping', icon: <Truck /> },
  { id: 'payment', label: 'Payment', icon: <CreditCard /> },
  { id: 'done', label: 'Confirmation', icon: <PackageCheck /> },
]

export default function StepIndicatorDemo() {
  const [current, setCurrent] = useState(1)

  return (
    <div className="mx-auto flex w-full max-w-sm flex-col gap-8 pt-12">
      <StepIndicator label="Checkout" steps={steps} current={current} onStepChange={setCurrent} />
      <div className="flex items-center justify-between text-sm">
        <span className="text-muted-foreground">
          Step {current + 1} of {steps.length}: <span className="text-foreground">{steps[current].label}</span>
        </span>
        <div className="flex gap-2">
          <button type="button" disabled={current === 0} onClick={() => setCurrent((c) => c - 1)} className="min-h-11 rounded-xl px-3 hover:bg-muted disabled:opacity-40">
            Back
          </button>
          <button
            type="button"
            disabled={current === steps.length - 1}
            onClick={() => setCurrent((c) => c + 1)}
            className="min-h-11 rounded-xl bg-foreground px-4 text-background disabled:opacity-40"
          >
            Next
          </button>
        </div>
      </div>
    </div>
  )
}

Source

step-indicator.tsx
// Based on Watermelon UI's “Step indicator” (MIT, © 2026 Watermelon Platform Contributors,
// github.com/WatermelonCorp/watermelon-platform). Rewritten with a current step, one moving label and no hidden measuring row.
import { AnimatePresence, MotionConfig, motion } from 'motion/react'
import { useRef, useState, type ReactNode } from 'react'
import { cn } from '@/lib/utils'

export type StepIndicatorStep = { id: string; label: string; icon?: ReactNode }

export type StepIndicatorProps = {
  steps: StepIndicatorStep[]
  /** Index of the step the person is on. Earlier steps are filled. */
  current: number
  onStepChange?: (index: number) => void
  label?: string
  className?: string
}

/** A row of bars for a multi-step flow. Hover or focus a bar and its name slides over to it. */
export function StepIndicator({ steps, current, onStepChange, label = 'Progress', className }: StepIndicatorProps) {
  const [hover, setHover] = useState<number | null>(null)
  const [x, setX] = useState(0)
  const row = useRef<HTMLDivElement>(null)
  const bars = useRef<(HTMLButtonElement | null)[]>([])
  const [slide, setSlide] = useState(false)

  const show = (i: number) => {
    const b = bars.current[i]
    const r = row.current
    if (!b || !r) return
    setSlide(hover !== null)
    setX(b.offsetLeft + b.offsetWidth / 2)
    setHover(i)
  }

  const step = hover === null ? null : steps[hover]

  return (
    <MotionConfig reducedMotion="user">
      <nav aria-label={label} className={cn('w-full', className)}>
        <div ref={row} className="relative flex h-3 items-center gap-2.5" onPointerLeave={() => setHover(null)}>
          <AnimatePresence>
            {step && (
              <motion.div
                key="tip"
                aria-hidden
                initial={{ opacity: 0, x, y: 4 }}
                animate={{ opacity: 1, x, y: 0 }}
                exit={{ opacity: 0, y: 4 }}
                transition={{ type: 'spring', bounce: 0, duration: slide ? 0.4 : 0 }}
                className="pointer-events-none absolute bottom-6 left-0"
              >
                <div className="-translate-x-1/2 overflow-hidden rounded-full bg-foreground px-4 py-2 text-background">
                  <AnimatePresence mode="popLayout" initial={false}>
                    <motion.span
                      key={step.id}
                      initial={{ opacity: 0, filter: 'blur(4px)' }}
                      animate={{ opacity: 1, filter: 'blur(0px)' }}
                      exit={{ opacity: 0, filter: 'blur(4px)' }}
                      transition={{ duration: 0.25 }}
                      className="flex items-center gap-2 text-sm font-medium whitespace-nowrap [&_svg]:size-4"
                    >
                      {step.icon}
                      {step.label}
                    </motion.span>
                  </AnimatePresence>
                </div>
              </motion.div>
            )}
          </AnimatePresence>
          {steps.map((s, i) => (
            <button
              key={s.id}
              ref={(el) => {
                bars.current[i] = el
              }}
              type="button"
              aria-label={`${i + 1}. ${s.label}`}
              aria-current={i === current ? 'step' : undefined}
              onPointerEnter={() => show(i)}
              onFocus={() => show(i)}
              onBlur={() => setHover(null)}
              onClick={() => onStepChange?.(i)}
              className="group relative h-3 flex-1 outline-none before:absolute before:-inset-y-3 before:inset-x-0"
            >
              <span
                className={cn(
                  'absolute inset-0 rounded-full transition-colors duration-300',
                  'group-focus-visible:ring-2 group-focus-visible:ring-ring group-focus-visible:ring-offset-2 group-focus-visible:ring-offset-background',
                  i <= current ? 'bg-foreground' : 'bg-muted',
                  hover === i && i > current && 'bg-muted-foreground/40',
                )}
              />
            </button>
          ))}
        </div>
      </nav>
    </MotionConfig>
  )
}

Install

npx shadcn@latest add https://mikkelmanniche.dk/lab/r/step-indicator.json

With the registry added (components.json)

npx shadcn@latest add @manniche/step-indicator

Dependencies

Files

  • step-indicator.tsx

Manniche Lab · open source

Free tools for AI agents and web development.