Detent Dial - React Component | Kokonut UI

Detent Dial

Rotary knob that clicks from notch to notch and coasts when flicked, built with React and Motion.

Install with

npx shadcn@latest add https://kokonutui.com/r/detent-dial.json

Installation

Detent Dial is a free, open-source React component in the Kokonut UI Inputs collection. Add it with the shadcn CLI, which copies the source into components/kokonutui/detent-dial.tsx, so the code is yours to change.

npx shadcn@latest add @kokonutui/detent-dial

Or add it by hand: install its packages, then copy the source from the above into components/kokonutui/detent-dial.tsx.

npm install motion

Usage

import DetentDial from "@/components/kokonutui/detent-dial";

export default function Example() {
  return <DetentDial />;
}

Props

Prop Type Default Description
label string "Temperature" Accessible name, also shown inside the knob.
min number 16 Minimum value.
max number 30 Maximum value.
step number 0.5 Increment step.
defaultValue number 21 Initial value when uncontrolled. Double-clicking returns here.
value number Controlled value.
onValueChange (value: number) => void Callback to capture value changes.
formatValue (value: number) => string Default (v) => ${v.toFixed(1)}°`
Formats the readout, end labels and aria-valuetext.
size number 240 Diameter in px.
disabled boolean false Disable the component.
className string Extra classes for the root element.

Dependencies

Needs Version Comes from
motion ^12.23.25 npm, installed by the CLI
cn from lib/utils.ts shadcn init
React 19 Your app
Tailwind CSS 4 Your app

No provider, font or global CSS to set up: the file works as soon as it lands.