countdown-main

Flip countdown timer library for React and Next.js.

Install

npm install countdown-main

Usage in Next.js

"use client";

import { FlipCountdown } from "countdown-main";
import "countdown-main/styles.css";

export default function PromoTimer() {
  return (
    <FlipCountdown
      targetDate="2026-12-31T23:59:59Z"
      showDays={true}
      onComplete={() => {
        console.log("Countdown complete");
      }}
    />
  );
}

Props

• targetDate: Date | string | number (required)
• showDays?: boolean (default true)
• labels?: { days?: string; hours?: string; minutes?: string; seconds?: string }
• className?: string
• onComplete?: () => void

Publish

1. Update version in package.json.
2. Build the package:

npm run build

3. Log in to npm:

npm login

4. Publish:

npm publish --access public

Local development

• Demo app: npm run dev
• Library build: npm run build