Stepper

Vertical Steps

A vertical step list where every step has room for an explanation and a timestamp, and its state is spelled out in a word beside the title.

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, descriptions and timestamps through steps
  • the active step number through current
  • the list's accessible name through label

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

Preview

1440pxHost theme
Vertical Steps — A vertical step list where every step has room for an explanation and a timestamp, and its state is spelled out in a word beside the title.

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-003?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

<Stepper003
  current={2}
  label="Application progress"
/>

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

Settings

Current step
current · default: 2
Screen reader name
label · default: Application progress
Accent
accent · default: theme colour
Background
background · default: theme colour

FAQ

How do I add Vertical Steps 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 Vertical Steps depend on?
No npm packages beyond React and Tailwind CSS.
What can I change in Vertical Steps?
Adapt: the steps, descriptions and timestamps through steps; the active step number through current; the list's accessible name through label. Keep as installed: the local --vibeui-stepper-003-* palette — do not swap it for your theme tokens; aria-current="step" on the current step: otherwise there is no way to hear where the user stands; the state word: a filled connector does not exist for a screen reader.
Is Vertical Steps 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-003.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, zero dependencies, the palette in the --vibeui-stepper-003-* variables. Server component: no hooks. An item is a two-column grid: the circle takes the first column across all rows (grid-row: 1 / span 3) and the text goes into the second, so the description and the time align to the title without manual indents. The connecting line is the item's ::before: it starts under the circle and stops at the last step, so it does not dangle into empty space. The current step is marked aria-current="step", and each item's state is duplicated by the caption "Done / Now / Ahead": the line colour is not the only carrier of meaning.

Tags

  • stepper
  • vertical
  • timeline
  • status
Component source

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

Loading…