Counter Number

An animated numeric display component with smooth counting, formatting, sizes, and semantic color variants.

counter-number-default

counter-number-percentage

counter-number-currency

counter-number-decimal

counter-number-prefix

counter-number-seperator

counter-number-custom

Installation

pnpm dlx shadcn@latest add https://aliimam.in/r/counter-number.json

Usage

import { CounterNumber } from "@/components/ui/counter-number"
<div className="flex flex-wrap items-end gap-8">
  {/* Default */}
  <CounterNumber value={12345} />
 
  {/* With prefix/suffix */}
  <CounterNumber value={86} suffix="%" size="xl" color="success" />
 
  {/* Decimals */}
  <CounterNumber value={3.14159} decimalPlaces={3} size="lg" />
 
  {/* Currency */}
  <CounterNumber
    value={1299.99}
    currency="USD"
    decimalPlaces={2}
    size="xl"
    color="primary"
  />
 
  {/* Locale + separator */}
  <CounterNumber value={1000000} locale="de-DE" separator="." size="lg" />
 
  {/* Mono spacing for layout stability */}
  <CounterNumber value={2025} preserveAspectRatio className="font-medium" />
</div>

Props

PropTypeDefault
valuenumber—
startValuenumber0
durationnumber1000
decimalPlacesnumber0
prefixstring""
suffixstring""
separatorstring","
currencystring—
localestring"en-US"
size"sm" | "md" | "lg" | "xl" | "2xl""md"
color"default" | "primary" | "secondary" | "success" | "warning" | "error""default"
preserveAspectRatiobooleanfalse
classNamestring—
childrenReact.ReactNode—
onClick(event: React.MouseEvent<HTMLSpanElement>) => void—
onMouseEnter(event: React.MouseEvent<HTMLSpanElement>) => void—
onMouseLeave(event: React.MouseEvent<HTMLSpanElement>) => void—
idstring—
titlestring—
styleReact.CSSProperties—
...propsReact.ComponentPropsWithoutRef<"span">—