vibecodng.com

Free MCP betaIndex and tools live

Measured entry

reui-stepper

progressminimal-flat

A client-side React compound component for interactive horizontal or vertical step flows. It ships as copied TypeScript from a shadcn registry and provides controlled or uncontrolled state, panels, keyboard navigation, loading states, and disabled states. It depends on radix-ui's Slot, Tailwind utility classes and theme tokens, plus a local cn helper.

Specimen
Harness screenshot of reui-stepper at 375 pixels wide
Harness screenshot at 375 pixels wide. No horizontal overflow recorded.
Harness screenshot of reui-stepper at 768 pixels wide
Harness screenshot at 768 pixels wide. No horizontal overflow recorded.
Harness screenshot of reui-stepper at 1440 pixels wide
Harness screenshot at 1440 pixels wide. No horizontal overflow recorded.

Measured

Every value below was written by the harness on the run that produced the frames above. None of it is derived from the prose.

Harness measurements recorded for reui-stepper
BuildOK
MountOK
Console errors0
Uncaught page errors0
Horizontal overflowclean at 375, 768, 1440
Axe critical3
Axe serious0
Axe moderate0
Axe minor0
Gzip marginal32.8 KB (98.3 KB build, 65.5 KB baseline)
Bare modeOK
Provider requiredNO
Demo usedwritten from the component source API

Verdict

A solid pick for shadcn-based interactive step flows, with a useful compound API and deliberate keyboard behavior. It does not work as a bare drop-in and needs a shadcn-style setup; workflow validation still belongs to the caller.

Use it if

  • You are building a multistage form or onboarding flow where users should move through tab-like steps.
  • You need both horizontal and vertical layouts with replaceable indicators and separately rendered step content.
  • Your app already follows shadcn conventions for Tailwind tokens, path aliases, and copied component source.

Skip it if

  • You need the component itself to enforce validation or linear progression, since workflow rules remain the caller's responsibility.
  • You only need a read-only progress display and do not want interactive tab behavior or local step state.
  • Your design system does not use Tailwind utilities and you do not want to translate its token-based styling.
  • The feature must remain server-only, since this component is explicitly a client module.

Install

Installation record for reui-stepper
Declared dependenciesradix-ui, clsx, tailwind-merge
Missing on installnone
Bare installbuilds and mounts without the shadcn-style helpers
Providerno provider required in the harness

In a non-shadcn project, add the radix-ui package, a cn class-merging helper at the expected alias, Tailwind processing, and matching theme tokens for primary, accent, muted, background, foreground, and ring colors. Configure the path alias or rewrite the import, then place the component in a client-capable React module.

Source and credit

This page is a review, not a copy. The component source lives with its author and this site does not republish it. Read the license before you use anything.

Author repository

github.com/keenthemes/reui
License
MIT
Record published
2026-08-18

Alternatives

Other published entries for the progress pattern, ordered by what they measured: mounts first, then clean axe scans, then bare-mode passes, then the smaller bundle.