Skip to content
Design System
GitHub

Where someone is in a fixed sequence of steps: done, current, upcoming and error steps, horizontal or vertical, with a compact bar for phones.

  1. ConnectPair over Wi-Fi, completed
  2. Map the siteWalk the robot once, current step
  3. Set routes, not started
  4. Test run, not started

Stepper default

Install
npx shadcn add @syncrobotic/stepper

Also installs: lucide-react, @syncrobotic/cn, @syncrobotic/use-presence

Overview

Shows where someone is in a fixed sequence of steps, which are done, and which failed.

When to use

  • Commissioning a robot.
  • An import or upload wizard.
  • A pre-shift checklist done in order.

Use something else

More examples

States and real uses. Each example is also a Storybook story and a visual regression test.

  1. Connect, current step
  2. Map the site, not started
  3. Set routes, not started
  4. Test run, not started
Step 1: Connect

Stepper interactive

  1. ConnectPaired with Patrol dog 7F3A, completed
  2. Map the siteWalk the robot along every corridor once, current step
    Mapping Hall B · 64 % of the floor covered
  3. Set routes, not started
  4. Test run, not started

Stepper vertical

  1. Connect, completed
  2. Map the siteMap has gaps, has an error
  3. Set routes, current step
  4. Test run, not started

Stepper with error

  1. Account, completed
  2. Invite teamOptional, current step
  3. First site, not started

Stepper optional step

  1. Upload, completed
  2. Check, completed
  3. Import, current step
  4. Done, not started

Stepper small

  1. Connect, completed
  2. Map the site, completed
  3. Set routes, completed
  4. Test run, completed

Stepper complete

Map the siteStep 2 of 4

Stepper compact bar

  1. Battery above 80 %94 %, completed
  2. Lidar cleanChecked 07:52, completed
  3. Emergency stop testedChecked 07:53, completed
  4. Route loaded, current step

Stepper vertical checklist

  1. Notifications, current step

Stepper free order

  1. Connect, completed
  2. Map the site, current step
  3. Lift accessNeeds the building’s API key, unavailable
  4. Test run, not started

Stepper disabled step

  1. ConnectPaired with 7F3A, completed
  2. Map the siteMap has gaps, has an error
    Two rooms were not reached: Hall B storage, Dock 2 office.
  3. Set routes, current step
  4. Test run, not started

Stepper vertical error

Usage rules

  • Only for a fixed sequence people go through once (commissioning, an import). Sections of a page are Tabs.
  • The current step is the neutral primary, never blue: blue means a machine is working.
  • An error step says why in its description.
  • Phones: StepperCompact, not a squeezed row of circles.

Changelog

  • 0.23.02026-11-20Every word it says can be translated without editing the source: Stepper and StepperCompact take labels ("Optional", each state as read by screen readers, "Step 2 of 5", the progress bar's name).
  • 0.17.32026-11-19Tracks and quiet shapes use the new --track token, so they read in dark mode (1.5:1 on their surface; they were near invisible).
  • 0.17.22026-11-19Steps share the row equally. When there is not about 6rem per step, the labels go to screen readers and the current step's title and description show once, full width, under the row (they were squeezed into their share and hyphenated).

How to upgrade