Skip to content

NewMCP server for your coding agent. Set it up ›

Nexus UI
Get Pro

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

PropTypeDefaultWhat it does
SplitFlapBoard.tomount + 2d 14:37:09Moment to count down to, as a Date or epoch milliseconds.
SplitFlapBoard.label"Launch · MK 4.0"Heading in the top-left corner.
SplitFlapBoard.liveLabel"Live"Text next to the pulsing dot in the top-right corner.
SplitFlapBoard.statusLabel"Status"Caption above the status row.
SplitFlapBoard.statuses["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—Shows this status instead of the statuses list (controlled).
SplitFlapBoard.onComplete—Called once when the countdown reaches zero.
SplitFlapBoard.autoplayfalseRotates the status line every 4.2s until someone presses the board. The countdown always runs.
SplitFlapBoard.className—Extra classes for the board.
WatchCountdown.to12 days 7:43:21 after the clock startsMoment 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"Nexus 3.0 ships in"Small caption above the rings.
WatchCountdown.className""Extra classes for the card.
FuseCountdown.seconds24How long the fuse burns, in seconds.
FuseCountdown.title"Doors open in"Caption shown while the fuse burns.
FuseCountdown.launchMessage"Nexus 3.0 is out. Go look."Message shown once the rocket has gone up.
FuseCountdown.onLaunchundefinedCalled once each time the fuse reaches the rocket.
FuseCountdown.autoplayfalseAfter each launch, relights the fuse by itself until someone presses the card or the button.
FuseCountdown.className""Extra classes for the card.

Add it to your project

  1. 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 creates components.json and the cn() helper in src/lib/utils.ts:

    npx shadcn@latest init -d

    Starting from nothing? The Quick Start walks through the whole thing.

  2. 2

    Connect the registry

    Run this once per project. It writes the Nexus UI entry into components.json for 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.

  1. 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
  2. 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.tsx
    animated-countdown/
    animated-countdown.tsx
    fuse-countdown.tsx
    index.ts
    split-flap-board.tsx
    watch-countdown.tsx
  3. 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:

  4. 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.

Guides