Animated Countdown, animated React component
Flip-style countdown timer with four variants — modern, digital, minimal, and classic. Smooth number transitions powered by Framer Motion. Also includes the Motion Kit Split-Flap Board variant. Also includes Watch Countdown, where days, hours, minutes and seconds empty around four concentric rings with glowing heads and rolling digits. Also includes Fuse Countdown, where a spark burns along a rope fuse at the pace of the clock and sets off a rocket and fireworks at zero.
- Free
- Motion Effects
- Spring
Animated Countdown
Split-Flap Board
Watch Countdown
Fuse Countdown
Like Animated Countdown? 256 more are in Pro.
Pro unlocks all 256 Pro components, every template and block, and everything we release next. Animated Countdown stays free.
Set it up, copy the code
Choose values for the main props and the JSX on the right updates to match.
Heading in the top-left corner.
Text next to the pulsing dot in the top-right corner.
Caption above the status row.
Shows this status instead of the statuses list (controlled).
Rotates the status line every 4.2s until someone presses the board. The countdown always runs.
Extra classes for the board.
Small caption above the rings.
Extra classes for the card.
Your JSX
<AnimatedCountdown
SplitFlapBoard.label="Launch · MK 4.0"
SplitFlapBoard.liveLabel="Live"
SplitFlapBoard.statusLabel="Status"
SplitFlapBoard.status=""
SplitFlapBoard.autoplay={false}
SplitFlapBoard.className=""
WatchCountdown.title="Nexus 3.0 ships in"
WatchCountdown.className=""
/>Props
| Prop | Type | Default | What it does |
|---|---|---|---|
| SplitFlapBoard.to | Date | number | mount + 2d 14:37:09 | Moment to count down to, as a Date or epoch milliseconds. |
| SplitFlapBoard.label | string | "Launch · MK 4.0" | Heading in the top-left corner. |
| SplitFlapBoard.liveLabel | string | "Live" | Text next to the pulsing dot in the top-right corner. |
| SplitFlapBoard.statusLabel | string | "Status" | Caption above the status row. |
| SplitFlapBoard.statuses | string[] | ["BOARDING", "ON TIME", "GATE B12", "FINAL CALL"] | Status lines; the first is shown and autoplay rotates through them. Up to 10 characters fit. |
| SplitFlapBoard.status | string | — | Shows this status instead of the statuses list (controlled). |
| SplitFlapBoard.onComplete | () => void | — | Called once when the countdown reaches zero. |
| SplitFlapBoard.autoplay | boolean | false | Rotates the status line every 4.2s until someone presses the board. The countdown always runs. |
| SplitFlapBoard.className | string | — | Extra classes for the board. |
| WatchCountdown.to | Date | number | 12 days 7:43:21 after the clock starts | Moment to count down to, as a Date or epoch milliseconds. Without it the card counts down from a fixed offset taken at the first client clock reading. |
| WatchCountdown.title | string | "Nexus 3.0 ships in" | Small caption above the rings. |
| WatchCountdown.className | string | "" | Extra classes for the card. |
| FuseCountdown.seconds | number | 24 | How long the fuse burns, in seconds. |
| FuseCountdown.title | string | "Doors open in" | Caption shown while the fuse burns. |
| FuseCountdown.launchMessage | string | "Nexus 3.0 is out. Go look." | Message shown once the rocket has gone up. |
| FuseCountdown.onLaunch | () => void | undefined | Called once each time the fuse reaches the rocket. |
| FuseCountdown.autoplay | boolean | false | After each launch, relights the fuse by itself until someone presses the card or the button. |
| FuseCountdown.className | string | "" | Extra classes for the card. |
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
Run this once per project. It writes the Nexus UI entry into
components.jsonfor you:npx shadcn@latest registry add "@nexus-labs=https://www.nexus-ui.com/api/registry/{name}"Type it exactly as shown.
{name}is filled in by the CLI with the component you ask for, so you never replace it.
- 3
Add the component
Run this from your project root. It adds the component, the helpers it imports and its npm packages.
npx shadcn@latest add @nexus-labs/animated-countdown
- 4
Check what was added
With a project made as in the Quick Start (a
src/folder), these files land in it:components/animated-countdown.tsxanimated-countdown/animated-countdown.tsxfuse-countdown.tsxindex.tssplit-flap-board.tsxwatch-countdown.tsx - 5
Copying by hand? Skip the registry
Instead of steps 2 and 3 you can copy the files yourself, with no registry and no API key. Step 1 still applies, so that
cn()exists. Install the packages:npm install framer-motion
Then show the source and create each file at the path it gives:
- 6
Use it in a page
Installing only adds the files. Import the component in a page and render it. The Usage tab on the preview shows a fuller example with props:
// src/app/page.tsx import { AnimatedCountdown } from "@/components/animated-countdown"; export default function Page() { return ( <main> <AnimatedCountdown /> </main> ); }
Like Animated Countdown? 256 more are in Pro.
Pro unlocks all 256 Pro components, every template and block, and everything we release next. Animated Countdown stays free.
About Animated Countdown
The Animated Countdown is a flip-style countdown timer with four visual variants — modern, digital, minimal, and classic — driven by Framer Motion spring layout animations for number transitions. It accepts any target date and updates in real time, displaying days, hours, minutes, and seconds. The flip transition between numbers animates with spring physics for a satisfying mechanical feel. Use it on product launch pages, promotional deadlines, and event countdown sections.
Good for
- Product launch and reveal countdown pages
- Sale and promotion deadline displays
- Event registration countdown sections
- Waitlist deadline and urgency indicators
Animated Countdown questions
How do I set the date it counts down to?
Pass `targetDate` as a Date, an ISO string or a timestamp. Without a target it shows a static demo time, which you can set with `initialStaticTime`.
What styles are available?
`variant` can be "modern", "digital", "minimal" or "classic", and `size` can be "sm", "md" or "lg". Separators between units are on by default for the digital style.
Can I run code when the timer reaches zero?
Yes. `onComplete` is called once when the countdown finishes, and `completionMessage` shows a line of text under the timer.
Can I hide days or seconds?
Use `showDays`, `showHours`, `showMinutes` and `showSeconds`, and `unitOrder` to change the order. With reduced motion enabled, digits swap with a quick fade instead of sliding.