Stepper

Step Progress

A step bar where the track fill springs across to the next node while the node itself pops. Back and Next buttons walk the chain.

React + Tailwind, shadcn-compatible: press “Copy for AI” and your Cursor or Claude Code agent installs it with the shadcn CLI.

What you can change

  • the steps array: the step names and how many there are
  • defaultStep — the step the component starts on
  • the backLabel and nextLabel copy

A link for your AI agent: preview, code and instructions.

Preview

1440pxHost theme
Step Progress — A step bar where the track fill springs across to the next node while the node itself pops. Back and Next buttons walk the chain.

Use it with AI

  1. 1. Copy the link.
  2. 2. Write to your agent in your own words and drop the link into the sentence.
  3. 3. The agent opens the link and installs the component from the registry.
AI
1Pick it here

put this on the home page as the hero:

https://vibeui.club/c/stepper-016?lang=en&theme=dark

2Paste into the chat
3Get it in your project

Not sure where to paste it? Step-by-step guide

Show the full instructions

What the link says, spelled out. Use it when your agent cannot open links — paste this text instead.

Loading…

How to use

<Stepper016
  steps={["Cart", "Delivery", "Payment", "Done"]}
  defaultStep={2}
/>

A sample call. The agent installs the component itself from the registry via the “Copy for AI” link.

Settings

Step
defaultStep · default: 2
Back button
backLabel · default: Back
Next button
nextLabel · default: Next
Accent
accent · default: theme colour
Background
background · default: theme colour

FAQ

How do I add Step Progress with Cursor or Claude Code?
Press “Copy for AI” on this page and paste it into your agent's chat. The instruction contains the shadcn CLI install command, the dependencies and what to keep, so the agent installs this exact component instead of recreating a lookalike.
What does Step Progress depend on?
No npm packages beyond React and Tailwind CSS.
What can I change in Step Progress?
Adapt: the steps array: the step names and how many there are; defaultStep — the step the component starts on; the backLabel and nextLabel copy. Keep as installed: the local --vibeui-stepper-016-* palette — do not swap it for your theme tokens; the fill on scaleX rather than on width: transform does not trigger layout; the linear() spring on both the fill and the node pop — without the overshoot the change reads as a repaint.
Is Step Progress free?
Yes. The preview is open without an account; with a free account you can copy up to 20 components a month.

For developers

npx shadcn@latest add https://vibeui.club/r/pro/stepper-016.json

This command needs a signed link: sign in and open “Component source” below — it issues a working link valid for 30 minutes. All install options

Technical notes

The component is self-contained: one file, no dependencies, its own palette in the local --vibeui-stepper-016-* variables. Client-side: "use client" for the current-step state. The fill is a single element stretched with scaleX(var(--vibeui-stepper-016-progress)) on a linear() spring curve — transform does not trigger layout, so the spring stays smooth even on a long list. The track starts at the centre of the first node and ends at the centre of the last: the --vibeui-stepper-016-inset offset is derived from the number of steps rather than from the node width, because the nodes split the row evenly. Completed steps show a check instead of a number, and the current one gets a scale and aria-current="step". The theme comes from light-dark() plus the :where(.dark,[data-theme="dark"]) … {color-scheme:dark} rule.

Tags

  • stepper
  • progress
  • steps
  • spring
  • checkout
Component source

The same file your agent installs. Here in case you would rather copy it by hand.

Loading…