Stepper
Stage Rail
A horizontal stage rail: the connector takes the colour of a completed stage, and on narrow widths the rail scrolls with scroll-snap instead of folding into a column.
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 heading through title
- the stages through stages: title, date and state done/current/todo
- the accent 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/timeline-007?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
<Timeline007
title="Deal stages"
stages={[
{ title: "Request", date: "March 3", state: "done" },
{ title: "Contract", date: "today", state: "current" },
{ title: "Handover", date: "April", state: "todo" },
]}
/>A sample call. The agent installs the component itself from the registry via the “Copy for AI” link.
Settings
- Heading
title· default: Deal stages- Accent
accent· default: theme colour- Surface
background· default: theme colour
More in Stepper
FAQ
- How do I add Stage Rail 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 Stage Rail depend on?
- No npm packages beyond React and Tailwind CSS.
- What can I change in Stage Rail?
- Adapt: the heading through title; the stages through stages: title, date and state done/current/todo; the accent colour through accent. Keep as installed: the local --vibeui-timeline-007-* palette — do not swap it for your theme tokens; the horizontal axis at every width: a path folded into a column stops reading as a path; the connector built from the stage's pseudo-element — it takes the state colour and vanishes at the last node.
- Is Stage Rail 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/timeline-007.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 local --vibeui-timeline-007-* variables. Server component: no hooks. The connector is each stage's pseudo-element, stretched from the centre of the node to the centre of the next one through left: calc(50% + 1rem) and right: calc(-50% + 1rem); it is coloured by its own stage's state and removed on the last one. A narrow width does not flip the rail into a column: a horizontal path folded into a vertical one lies about the order, so the list scrolls with scroll-snap-type: x proximity. The current node is marked with a box-shadow ring and aria-current="step". The theme comes from the surrounding color-scheme through light-dark(): the block has no surface by default, it sits on the page background and darkens along with it.
Tags
- timeline
- steps
- horizontal
- progress
Component source
The same file your agent installs. Here in case you would rather copy it by hand.
Loading…