# Stepper with breadcrumb steps

> 5-step new hire onboarding shown as step names split by chevrons, with a step counter, a 5-segment bar and the selected step's summary below.

A shadcn/ui block from the [@reui](https://reui.io) registry, listed on [shadcn.exchange](https://shadcn.exchange/r/reui/c-stepper-28).

- Page, with a live preview: https://shadcn.exchange/r/reui/c-stepper-28
- Screenshot: https://abzjhwgwpdpz7ua5.public.blob.vercel-storage.com/shots/reui/c-stepper-28-light-c29587ce35eb2fec.png
- Registry item: https://reui.io/r/new-york-v4/c-stepper-28.json
- Listed: 2026-10-13, source last changed 2026-10-13

## Install

```bash
npx shadcn@latest add https://reui.io/r/new-york-v4/c-stepper-28.json
```

Run it in a project that has shadcn/ui set up. It adds the files below and installs what they depend on.

## Dependencies

- npm packages: `cn`
- Registry items: `button`, `@reui/stepper`

## Files

### `c-stepper-28.tsx`

```tsx
"use client"

import { useId, useRef, useState } from "react"
import {
  Stepper,
  StepperContent,
  StepperItem,
  StepperNav,
  StepperPanel,
  StepperTitle,
  StepperTrigger,
} from "@/components/reui/stepper"
import { cn } from "cn"

import { Button } from "@/components/ui/button"
import { IconPlaceholder } from "@/app/(create)/components/icon-placeholder"

const steps = [
  {
    title: "Registration",
    summary: "Create your employee login and confirm your contact details.",
  },
  {
    title: "Paperwork",
    summary: "Sign your contract, tax forms and direct deposit details.",
  },
  {
    title: "Store Tour",
    summary: "Walk the floor, stockroom and break room with your manager.",
  },
  {
    title: "Job Training",
    summary: "Learn the register, returns and opening routine with a mentor.",
  },
  {
    title: "First Shift",
    summary: "Saturday from 9:00 AM to 3:00 PM, paired with your mentor.",
  },
]

export function Pattern() {
  const [current, setCurrent] = useState(4)
  const labelId = useId()
  const prevRef = useRef<HTMLButtonElement>(null)
  const nextRef = useRef<HTMLButtonElement>(null)
  // One past the last step marks every step complete. No tab is selected
  // then, so the last one keeps the tablist's tab stop.
  const allDone = current > steps.length

  function goTo(step: number) {
    setCurrent(step)
    // The pressed button disables itself at either end, so focus moves to its partner.
    if (step === 1) nextRef.current?.focus()
    if (step > steps.length) prevRef.current?.focus()
  }

  return (
    <Stepper
      value={current}
      onValueChange={setCurrent}
      className="@container max-w-200"
      aria-labelledby={labelId}
    >
      <div className="mb-4 flex flex-wrap items-baseline justify-between gap-x-6 gap-y-3">
        <p id={labelId} className="text-sm font-medium">
          Onboarding
        </p>

        {/* Under 48rem the steps drop to a row of their own and wrap there.
            From 48rem up they fill the space between the label and the
            counter and center in it, which is where justify-between would
            put them. The one-row header needs about 660px. */}
        <StepperNav className="order-last flex-wrap gap-y-2.5 @3xl:order-none @3xl:flex-1 @3xl:justify-center">
          {steps.map((item, index) => {
            const step = index + 1

            // The primitive grows every item but the last; these stay packed.
            return (
              <StepperItem
                key={item.title}
                step={step}
                className="not-last:flex-none"
              >
                {/* Margin and padding cancel out, so the text stays put while
                    the hit area grows to 24px and the focus ring gets room. */}
                <StepperTrigger
                  tabIndex={allDone && step === steps.length ? 0 : undefined}
                  className="-mx-1.5 -my-1.25 px-1.5 py-1.25"
                >
                  <StepperTitle className="text-muted-foreground data-[state=active]:text-foreground whitespace-nowrap">
                    {item.title}
                  </StepperTitle>
                  {step < current && (
                    <span className="sr-only">, completed</span>
                  )}
                </StepperTrigger>

                {step < steps.length && (
                  <IconPlaceholder
                    lucide="ChevronRightIcon"
                    tabler="IconChevronRight"
                    hugeicons="ArrowRight01Icon"
                    phosphor="CaretRightIcon"
                    remixicon="RiArrowRightSLine"
                    className="text-ring/50 group-data-[state=completed]/step:text-ring mx-1.5 size-3.5 rtl:rotate-180"
                    aria-hidden="true"
                  />
                )}
              </StepperItem>
            )
          })}
        </StepperNav>

        {/* Reads as "Step 4 of 5" to assistive tech. */}
        <p className="text-muted-foreground flex gap-1.5 text-xs whitespace-nowrap tabular-nums">
          <span>Step</span>
          <span>
            <span className="text-foreground">
              {Math.min(current, steps.length)}
            </span>{" "}
            <span aria-hidden="true">/</span>
            <span className="sr-only">of</span> {steps.length}
          </span>
        </p>
      </div>

      {/* The bar repeats the counter, so assistive tech skips it. */}
      <div aria-hidden="true" className="flex h-1 gap-1">
        {steps.map((item, index) => (
          <span
            key={item.title}
            className={cn(
              "flex-1 rounded-full",
              index < current ? "bg-foreground" : "bg-ring/20"
            )}
          />
        ))}
      </div>

      <StepperPanel className="mt-6 text-center">
        {steps.map((item, index) => (
          <StepperContent key={item.title} value={index + 1}>
            <p className="text-sm font-medium">{item.title}</p>
            <p className="text-muted-foreground text-sm">{item.summary}</p>
          </StepperContent>
        ))}
        <StepperContent value={steps.length + 1}>
          <p className="text-sm font-medium">Onboarding complete</p>
          <p className="text-muted-foreground text-sm">
            All {steps.length} steps are done, welcome to the team.
          </p>
        </StepperContent>
        <div className="mt-3 flex justify-center gap-2">
          <Button
            ref={prevRef}
            variant="outline"
            size="sm"
            disabled={current === 1}
            onClick={() => goTo(current - 1)}
          >
            Previous
          </Button>
          <Button
            ref={nextRef}
            variant="outline"
            size="sm"
            disabled={allDone}
            onClick={() => goTo(current + 1)}
          >
            Next
          </Button>
        </div>
      </StepperPanel>
    </Stepper>
  )
}
```