Where someone is in a fixed sequence of steps: done, current, upcoming and error steps, horizontal or vertical, with a compact bar for phones.
- ConnectPair over Wi-Fi, completed
- Map the siteWalk the robot once, current step
- Set routes, not started
- 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
- Sections of one page: Tabs.
- Progress of a machine task: Progress.
- Asking the questions themselves: Questionnaire.
More examples
States and real uses. Each example is also a Storybook story and a visual regression test.
- Connect, current step
- Map the site, not started
- Set routes, not started
- Test run, not started
Step 1: Connect
Stepper interactive
- ConnectPaired with Patrol dog 7F3A, completed
- Map the siteWalk the robot along every corridor once, current stepMapping Hall B · 64 % of the floor covered
- Set routes, not started
- Test run, not started
Stepper vertical
- Connect, completed
- Map the siteMap has gaps, has an error
- Set routes, current step
- Test run, not started
Stepper with error
- Account, completed
- Invite teamOptional, current step
- First site, not started
Stepper optional step
- Upload, completed
- Check, completed
- Import, current step
- Done, not started
Stepper small
- Connect, completed
- Map the site, completed
- Set routes, completed
- Test run, completed
Stepper complete
Map the siteStep 2 of 4
Stepper compact bar
- Battery above 80 %94 %, completed
- Lidar cleanChecked 07:52, completed
- Emergency stop testedChecked 07:53, completed
- Route loaded, current step
Stepper vertical checklist
- Notifications, current step
Stepper free order
- Connect, completed
- Map the site, current step
- Lift accessNeeds the building’s API key, unavailable
- Test run, not started
Stepper disabled step
- ConnectPaired with 7F3A, completed
- Map the siteMap has gaps, has an errorTwo rooms were not reached: Hall B storage, Dock 2 office.
- Set routes, current step
- 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).