Skip to content
VenusUI
Get started

Kitchen Timer

A wind-up kitchen timer: twist the dial to set it and it ticks back to zero, then rings.

Preview

Installation

npx shadcn@latest add @venusui/kitchen-timer

Run this in a project set up with shadcn. If you haven’t set it up yet, run npx shadcn@latest init first.

Files added to your project

Paths use the default shadcn aliases. The CLI follows the aliases in your components.json.

  • @/components/ui/kitchen-timer.tsx

Usage

The code behind the preview above.

kitchen-timer-demo.tsx

import { KitchenTimer } from "@/components/ui/kitchen-timer"

export default function KitchenTimerDemo() {
  return <KitchenTimer defaultMinutes={5} />
}

API reference

PropTypeDefaultDescription
maxnumber60Minutes on the dial.
defaultMinutesnumber0Starting time.
onDone() => void—Called when it rings.

All <div> props.

Requirements

  • React 19 and Tailwind CSS v4. The CLI adds the keyframes.

Customization

  • Set defaultMinutes to start it running straight away.

Accessibility

  • The dial is a slider (arrow keys add a minute, Page Up five); the time is a live timer.

Troubleshooting

Something looks different from the preview.
Components use your project’s theme tokens, so surrounding colours and radius follow your styles.
Unknown registry "@venusui"
Your shadcn CLI couldn’t find the namespace in the shadcn registry index. Use the latest CLI (npx shadcn@latest), install by URL, or register it with its address: npx shadcn@latest registry add @venusui=https://venusui.com/r/{name}.json.
No components.json found
Run npx shadcn@latest init in your project first.
Loading preview

Analog Clock

Data display

A station clock whose needle waits at twelve; drag the minute hand to set it by hand.

Loading preview

Bookshelf

Interactive

Books on a wooden shelf whose spines lift on hover and pull out when selected, with a matching cover.

Loading preview

Chat Thread

Data display

A messaging conversation that plays out with typing indicators; viewers can send replies too.