Components

Countdown

A countdown whose digits roll over like an odometer — for launches, drops and sales. It ticks exactly on the second and calls you when it reaches zero.

Paste it into ChatGPT, Claude, Cursor or v0.

Usage

React
import { Countdown } from '@vizzele/react';

<Countdown to="2026-12-24T00:00:00" onComplete={() => setLive(true)} />

Props

PropTypeDefaultDescription
toDate | string | number—The moment it reaches zero.
units('days' | 'hours' | 'minutes' | 'seconds')[]—Which to show. Default all four.
labelsPartial<Record<unit, string>>—Translate the labels.
onComplete() => void—Called once at zero.

Accessibility

  • A role="timer" (not announced every second) with the time left written out for screen readers, updated each minute.
  • Renders "--" on the server and fills in after load, so there is no hydration mismatch.