# Timer

> A countdown/stopwatch timer component with customizable duration, variants, sizes, and compound parts for building custom timers.

- Author: [cult/ui](https://21st.dev/@cult-ui)
- License: MIT
- Tags: Countdown, Clock, Timer, Stopwatch
- npm dependencies: lucide-react, class-variance-authority
- Live preview: https://21st.dev/@cult-ui/components/timer

## Install

```bash
npx shadcn@latest add "https://21st.dev/r/cult-ui/timer?api_key=$API_KEY_21ST"
```

Requires a 21st API key (generate one at https://21st.dev/mcp) passed as `API_KEY_21ST`. Free accounts get a limited number of installs per day; unlimited on a paid plan — see https://21st.dev/pricing.

Full component directory: https://21st.dev/llms.txt · More like this: https://21st.dev/community/components/s/countdown.md