Stage path
FREEWhere a record is in its process, and the way to move it.
Every shadcn style · one file
v2.0 · Updated Oct 13Live preview
pnpm dlx shadcn@latest add https://notchset.dev/r/stage-path.jsonInstallation
pnpm dlx shadcn@latest add https://notchset.dev/r/stage-path.jsonFree, no account or key. One command for every shadcn style. With the @notchset registry added, @notchset/<name> works too.
Works with React 18.3 or 19 on Tailwind CSS v4, in any shadcn project. What's tested
Install by hand
- 1. No extra packages: React is enough.
- 2. Copy the files to these paths (the source, or save them all as a .zip)
- components/ui/notchset/stage-path.tsx
- 3. No stylesheet needed.
- 4. Install what it builds on first: shadcn's cn helper (lib/utils.ts, from npx shadcn init), the theme foundation (its tokens and base styles)
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
Usage
Import it and pass your content. The props that matter most are listed next.
Example
"use client";
import * as React from "react";
import { StagePath } from "@/components/ui/notchset/stage-path";
const STAGES = { Discovery: "#8f9bb3", Evaluation: "#38a6d6", Proposal: "#9b87f5", "Security review": "#e3a33b", Procurement: "#ec7d55" };
const DAYS = [6, 12, 1, 9, 4];
export default function StagePathDemo() {
const [stage, setStage] = React.useState("Proposal");
const stages = Object.entries(STAGES).map(([k, c], i) => ({ value: k, label: k, color: c, days: DAYS[i] }));
return (
<div className="flex w-full max-w-[640px] flex-col gap-4">
<StagePath current={stage} onMove={setStage} stages={stages} />
{/* a closed deal: the path ends in its outcome and how long it took */}
<StagePath current="" onMove={() => {}} end={{ outcome: "won", label: "Won", detail: "in 32 days" }} reached={Object.keys(STAGES).slice(0, 4)} stages={stages.slice(0, 4)} />
</div>
);
}Source
components/ui/notchset/stage-path.tsx
Loading the code
Props
stages–Stage[]Required.
current–stringRequired.
onMove–(value: string) => voidRequired.
end–{ outcome: "won" | "lost"; label: string; detail?: string | undefined }reached–string[]
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Where agents read it
- Guide for this component: https://notchset.dev/md/stage-path.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://notchset.dev/api/mcp(setup)
Changelog
v2.0.0 · 2026-10-13
Released with the Notchset system.
Used in
The same file, at work in a finished app. Open it live and find it on its pages.
Part of a kit
Pipeline and deals. A board of deals by stage, each deal's next step, and the totals that move as you work.
3 free · 6 ProSee the Pipeline and deals kit
