Number Ticker

Installation

pnpm dlx shadcn@latest add @cleverui/number-ticker

Requires the @cleverui registry in your components.json, a one-off, two-line setup.

Usage

tsx

import { NumberTicker } from '@/components/ui/number-ticker'

Exampletsx

import { NumberTicker } from '@/components/ui/number-ticker'

const stats = [
  { label: 'Invoices reconciled', value: 4823917, suffix: '' },
  { label: 'Hours returned / mo', value: 38, suffix: 'h' },
  { label: 'Automation uptime', value: 99.98, suffix: '%', decimals: 2 },
  { label: 'Payback period', value: 11, prefix: '< ', suffix: ' days' },
]

export default function NumberTickerDemo() {
  return (
    <div className="mx-auto grid min-h-[360px] max-w-5xl grid-cols-2 items-center gap-x-6 gap-y-12 px-6 py-20 lg:grid-cols-4">
      {stats.map((s) => (
        <div key={s.label} className="border-l border-border/60 pl-5">
          <div className="text-3xl font-semibold text-foreground sm:text-4xl">
            <NumberTicker
              value={s.value}
              suffix={s.suffix}
              prefix={s.prefix}
              decimals={s.decimals ?? 0}
            />
          </div>
          <p className="mt-2 font-mono text-[11px] uppercase tracking-[0.2em] text-muted-foreground">
            {s.label}
          </p>
        </div>
      ))}
    </div>
  )
}

API reference

NumberTicker accepts the following props.

Prop	Type	Default	Description
`value`*	`number`	–	–
`from`	`number`	`0`	count up from this value
`duration`	`number`	`1.4`	seconds
`decimals`	`number`	`0`	–
`prefix`	`string`	`''`	–
`suffix`	`string`	`''`	–
`locale`	`string`	`'en-US'`	Intl locale for thousands separators

…plus everything from React.HTMLAttributes<HTMLSpanElement>: className, event handlers, aria attributes and the rest pass straight through.

Related components

Number Odometer

Multi-digit odometer where every digit rolls inside its own masked column, settling right to left like a meter, with prefix, suffix, and decimal support.

Number Milestone Row

A row of milestone numbers between hairline separators, each figure lands in sequence with a spring settle, and a primary tick draws itself under the final one.

Number Radial Gauge

Determinate SVG radial gauge, a hairline token track, one primary arc drawn via pathLength, a tabular counted value at center and a mono label beneath.

Number Segment Meter

Discrete React meter primitive, value-of-max rendered as Tailwind-token unit cells that fill in stepped sequence, with a mono fraction readout and threshold tick.

Stat Delta Chip

Compact metric chip pairing a counted-up value with a signed delta pill, direction glyph and token-honest color, primary for gains, destructive for losses.

Gym Stats Board

The gym's numbers board, members, classes a week, and PBs this month counting up in heavy tabular figures under bold condensed labels, with a plain-spoken honesty footnote.

Frequently asked questions

How do I install the Number Ticker component?

Register the @cleverui registry in your components.json ("@cleverui": "https://cleverops.com.au/r/{name}.json"), then run `npx shadcn@latest add @cleverui/number-ticker`. The shadcn CLI copies the source into your project, you own the code from that point. You can also copy the source directly from this page.

What dependencies does Number Ticker require?

Number Ticker uses motion on top of React and Tailwind CSS. You don't need to install it manually, the shadcn CLI resolves and installs npm dependencies automatically when you add the component.

Can I theme Number Ticker to match my brand?

Yes. The component is styled entirely with Tailwind utilities over standard design tokens (primary, background, muted, border), so it inherits your existing shadcn/ui theme automatically. Change your CSS variables and the component follows, no source edits needed for palette, radius, or fonts.

Preview & code