Stepper
Step States
Steps with the full set of states: done, error, skipped, current and upcoming. Each has its own glyph and its own word, not just a colour.
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 and their states through steps
- the list's accessible name through label
- the main colour through accent
A link for your AI agent: preview, code and instructions.
Preview

Use it with AI
- 1. Copy the link.
- 2. Write to your agent in your own words and drop the link into the sentence.
- 3. The agent opens the link and installs the component from the registry.
put this on the home page as the hero:
https://vibeui.club/c/stepper-004?lang=en&theme=dark
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
<Stepper004
label="Store setup"
accent="#4f46e5"
/>A sample call. The agent installs the component itself from the registry via the “Copy for AI” link.
Settings
- Screen reader name
label· default: Store setup- Accent
accent· default: theme colour- Background
background· default: theme colour
More in Stepper
FAQ
- How do I add Step States 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 States depend on?
- No npm packages beyond React and Tailwind CSS.
- What can I change in Step States?
- Adapt: the steps and their states through steps; the list's accessible name through label; the main colour through accent. Keep as installed: the local --vibeui-stepper-004-* palette — do not swap it for your theme tokens; the state word under the title: colour and glyph are indistinguishable to colour-blind readers; the dashed ring on a skipped step: shape backs up colour where colour fails.
- Is Step States 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-004.jsonThis 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, zero dependencies, the palette in the --vibeui-stepper-004-* variables. Server component: no hooks. The state arrives as data rather than being derived from the number: a skipped step can sit between completed ones. An item's colour is set by the single --vibeui-stepper-004-tone variable, which paints the circle, the border and the caption — a new state costs one line of CSS plus a glyph in MARKS and a word in WORDS. The connector takes its colour from the left-hand neighbour through an inline variable, so the break shows exactly where the error is. A skipped step is additionally marked with a dashed border: shape works where colour does not.
Tags
- stepper
- states
- error
- accessibility
Component source
The same file your agent installs. Here in case you would rather copy it by hand.
Loading…