Measured entry

ruixen-circular-stepper-input

inputliquid-glassmotion on file

A client-side React numeric stepper delivered as a shadcn registry component. It combines a draggable SVG ring, increment and decrement buttons, spring animation, injected light and dark theme styles, and optional Web Audio tick feedback. It depends on Motion and keeps its value in local state while exposing an onChange callback.

Specimen
Motion capture of the mounted demo, recorded by the harness. No audio track.
Harness screenshot of ruixen-circular-stepper-input at 375 pixels wide
Harness screenshot at 375 pixels wide. No horizontal overflow recorded.
Harness screenshot of ruixen-circular-stepper-input at 768 pixels wide
Harness screenshot at 768 pixels wide. No horizontal overflow recorded.
Harness screenshot of ruixen-circular-stepper-input 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 ruixen-circular-stepper-input
BuildOK
MountOK
Console errors0
Uncaught page errors0
Horizontal overflowclean at 375, 768, 1440
Axe critical0
Axe serious0
Axe moderate0
Axe minor0
Gzip marginal61.1 KB (126.5 KB build, 65.4 KB baseline)
Bare modeOK
Provider requiredNO
Demo usedwritten from the component source API

Verdict

A polished option for bounded numeric settings when the circular interaction suits the product. It builds and mounts cleanly without a provider, but its local-only state model and relatively substantial Motion cost make it a deliberate choice rather than a general input replacement.

Use it if

  • You need a compact numeric setting that users can adjust by dragging or with explicit step buttons.
  • Your interface already uses soft glass styling and Motion-based interaction feedback.
  • An uncontrolled input with a default value and change callback fits your form architecture.

Skip it if

  • Your form requires a controlled value prop or synchronization with externally updated state.
  • You need a conventional text or range input with native form submission semantics.
  • You want to avoid adding Motion for a single compact control.
  • Your product cannot use interaction sounds unless each user explicitly enables them.

Install

Installation record for ruixen-circular-stepper-input
Declared dependenciesmotion
Missing on installnone
Bare installbuilds and mounts without the shadcn-style helpers
Providerno provider required in the harness

In a non-shadcn React project, copy the client component into the codebase and add the Motion package. Ensure the framework supports client components and browser APIs. The component injects its own theme styles, so no utility CSS setup or provider is required; set sound off if audio feedback is inappropriate.

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.

Alternatives

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