@stepper

A single, focused shadcn/ui-style registry primitive for multi-step flows in React, Next.js, and Tailwind CSS projects. Headless and stateful: provides typed, value-safe step primitives (Stepper, StepperContent, StepperItem, StepperIndicator, StepperLabel, StepperList, StepperTrigger) with built-in ARIA attributes, guard support, and a predictable state machine. Does not own form state, routing, or validation — your app drives the flow. Installed as owned source via shadcn CLI. Currently in beta; open-source MIT. Use for: building accessible, typed multi-step wizards or onboarding flows in a shadcn/ui project without coupling to a heavyweight form-wizard library.

3 components react shadcn-cli MIT

website ↗ github ↗ registry ↗

Install this registry

shadcn (npm) npx shadcn@latest add https://francozeta-stepper.vercel.app/registry.json

pnpm pnpm dlx shadcn@latest add https://francozeta-stepper.vercel.app/registry.json

bun bunx shadcn@latest add https://francozeta-stepper.vercel.app/registry.json

fetch registry curl -s https://francozeta-stepper.vercel.app/registry.json

Components

3 total

Stepper ui

A lightweight, composable stepper primitive for shadcn/ui-style multi-step flows.

npx shadcn@latest add https://francozeta-stepper.vercel.app/stepper.json

Stepper Demo block

A styled Stepper demo with a default export and the Stepper source primitive.

npx shadcn@latest add https://francozeta-stepper.vercel.app/stepper-demo.json

Stepper Intent Onboarding block

An intent-driven onboarding block with hidden Stepper state, intent routing, profile validation, interests, async setup, and a signed-in completion state.

npx shadcn@latest add https://francozeta-stepper.vercel.app/stepper-intent-onboarding.json