Date Wheels, animated React component
A date picker made of three drums, day, month and year, each a real cylinder in 3D. Fling one and it carries on with your speed and springs to rest dead centre on a row; scroll it or tap a row. A glass band across the middle magnifies the chosen rows, each row ticks softly as it passes, and the date above rolls its digits as the drums turn.
- Pro
- Inputs & Controls
- 3D
- Spring
A soft tick as each day, month or year passes the glass band. Sound is off on this site until you switch it on.
Play with it
Move the controls and watch it change. Copy code gives you a snippet with only the props you changed.
Drag or scroll a drum, or tap a row.
Props
| Prop | Type | Default | What it does |
|---|---|---|---|
| defaultValue | Date | — | The date the drums start on. |
| onChange | (date: Date) => void | — | Called with the new date whenever a drum comes to rest. |
| minYear | number | 1900 | The first year on the year drum. |
| maxYear | number | 2100 | The last year on the year drum. |
| enableSound | boolean | true | A soft tick as each day, month or year passes the lens. They also follow the site-wide sound switch. |
| volume | number | 0.8 | Sound level, 0 to 1. |
| autoplay | boolean | false | Plays a short demo by itself until the visitor touches it. Never runs under reduced motion. |
| className | string | "" | Extra classes for the outer element. |
Add it to your project
- 1
Set up your project once
You need a Next.js project with Tailwind CSS and the
@/import alias. In its root folder, run this once. It createscomponents.jsonand thecn()helper insrc/lib/utils.ts:npx shadcn@latest init -d
Starting from nothing? The Quick Start walks through the whole thing.
- 2
Connect the registry with your API key
Date Wheels is a Pro item, so the CLI has to send your API key. Do this once per project:
- Create a key at nexus-ui.com/dashboard/api-key. Copy it straight away: it starts with
nxs_and is shown only once. - In your project root, next to
package.json, create a file named.env.localwith this line, using your own key:NEXUS_API_KEY=nxs_your_key_here
- Open
components.jsonand add this entry inside the outermost braces, next to"aliases". Leave{name}and${NEXUS_API_KEY}exactly as written; the CLI fills them in:"registries": { "@nexus-labs": { "url": "https://www.nexus-ui.com/api/registry/{name}", "headers": { "Authorization": "Bearer ${NEXUS_API_KEY}" } } }
- Create a key at nexus-ui.com/dashboard/api-key. Copy it straight away: it starts with
How Date Wheels works
A date picker made of three drums: day, month and year. Each is a real cylinder in CSS 3D, its rows curving away and dimming toward the top and bottom. Drag one and let trackpad, or tap a row to bring it to the middle. A band of glass runs across the middle and the rows inside it are Above, the date is spelt out large, its digits rolling as they change. The day drum shortens to fit the month, and a day that no longer exists slides back to the last one.
The source, the install command and the build prompt come with Pro.
Date Wheels questions
Does it make sound, and how do I turn it off?
A soft tick as each day, month or year passes the glass band. Sounds are synthesised with the Web Audio API, so there are no audio files, and they only play after a click or key press. Pass `enableSound={false}` to silence this component, or call `setSoundsEnabled(false)` from `@/lib/ui-sounds` to switch every sound off at once. The CLI installs `@/lib/ui-sounds` with the component.