Measured entry

ruixen-banner-countdown

cardunclassified

A client-side React countdown banner shipped as a single shadcn registry component. It renders rolling day, hour, minute, and second pairs, plus an optional link and dismiss action. It relies on Tailwind theme utilities, lucide-react, a local cn helper backed by clsx and tailwind-merge, and global digit-animation keyframes that the registry item does not include.

Specimen
Harness screenshot of ruixen-banner-countdown at 375 pixels wide
Harness screenshot at 375 pixels wide. No horizontal overflow recorded.
Harness screenshot of ruixen-banner-countdown at 768 pixels wide
Harness screenshot at 768 pixels wide. No horizontal overflow recorded.
Harness screenshot of ruixen-banner-countdown at 1440 pixels wide
Harness screenshot at 1440 pixels wide. No horizontal overflow recorded.

Measured

Every value below was written by the harness on the run that produced the frames above. None of it is derived from the prose.

Harness measurements recorded for ruixen-banner-countdown
BuildOK
MountOK
Console errors0
Uncaught page errors0
Horizontal overflowclean at 375, 768, 1440
Axe critical0
Axe serious0
Axe moderate0
Axe minor0
Gzip marginal32.0 KB (97.5 KB build, 65.5 KB baseline)
Bare modeFAIL
Provider requiredNO
Demo usedwritten from the component source API

What the harness recorded

BARE BUILD

✗ Build failed in 1m 11s
error during build:
[vite:load-fallback] Could not load <sandbox>/src/lib/utils (imported by src/cut/components/ruixen/banner-countdown.tsx): ENOENT: no such file or directory, open '<sandbox>/src/lib/utils'

Verdict

A focused promo banner with useful callbacks, clean responsive wrapping, and no provider requirement. It is a sound copy-in choice for an existing Tailwind system, but it needs a shadcn-style setup and extra global keyframes before the rolling digits are complete.

Use it if

  • You need a dismissible promotion or launch banner that counts down to a client-supplied date.
  • You want an optional call-to-action link and callbacks for expiration and dismissal.
  • Your Tailwind app already uses shadcn-style theme tokens and a shared cn utility.

Skip it if

  • You need server-authoritative timing that is resistant to device clock changes or background-tab throttling.
  • You need dismissal to persist across reloads without adding your own storage logic.
  • You want a drop-in component for a non-Tailwind codebase or cannot add the missing animation keyframes.

Install

Installation record for ruixen-banner-countdown
Declared dependencieslucide-react, clsx, tailwind-merge
Missing on installnone
Bare installfails once the shadcn-style helpers are removed, so it needs that setup
Providerno provider required in the harness

In a non-shadcn project, add Tailwind CSS and the foreground, muted-foreground, and border theme tokens; install lucide-react, clsx, and tailwind-merge; create a cn helper; configure the local import alias or replace it with a relative path; and define the digit-in and digit-out keyframes referenced by the component. The file must run as a React client component.

Source and credit

This page is a review, not a copy. The component source lives with its author and this site does not republish it. Read the license before you use anything.

Alternatives

Other published entries for the card pattern, ordered by what they measured: mounts first, then clean axe scans, then bare-mode passes, then the smaller bundle.