Show progress through steps, horizontally or vertically, with each step's content.
Import it and pass your content. The props that matter most are listed next.
"use client";
import * as React from "react";
import { Stepper, type StepperStep } from "@/components/ui/notchset/stepper";
const steps: StepperStep[] = [
{ label: "Connect", description: "Add your API key" },
{ label: "Pick agents", description: "Planner, Triage" },
{ label: "Run evals", description: "1,200 cases" },
];
export function Onboarding() {
const [step, setStep] = React.useState(1);
return (
<div className="grid gap-3">
<Stepper steps={steps} value={step} orientation="horizontal" />
<button type="button" onClick={() => setStep((s) => Math.min(steps.length, s + 1))}>
Next
</button>
</div>
);
}steps–
{ label, description?, content? }[]The steps and what each shows.
value–
numberThe current step.
complete–
booleanEvery step done.
orientation–
"horizontal" | "vertical"Content below a rule, or inline under the current step.
Stepperdata-slot="stepper"
The steps.
StepNodedata-slot="—"
The 24px node, for your own layouts.
components/ui/notchset/stepper.tsx
pnpm dlx shadcn@latest add https://notchset.dev/r/stepper.jsonpnpm dlx shadcn@latest add https://notchset.dev/r/radix-nova/stepper.jsonFree, no account or key. Use the command for your project's primitives: a radix-*, new-york or default style in components.json is Radix, a base-* style is Base UI. With the @notchset registry added, @notchset/<name> picks for you.
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.
Give your coding assistant the Markdown guide instead of screenshots.
https://notchset.dev/api/mcp (setup)v1.0.0 · 2026-10-02
First release