build69
build69  /  Components  /  Motion — Text Animations  /  NumberTicker

NumberTicker

v1.0.3Updated 28 Sept 2026

Animated counting number for KPI reveals. Spring-driven via motion/react with locale-aware Intl.NumberFormat — integer, currency, percent, or decimal formats with size and tone tokens.

Preview

Live · 12 stories
DefaultOpen ↗
▸Why this is recommendedanimationnumbertickercount-up+3

The default, out-of-the-box NumberTicker.

Recommended for+14
  • ✓Hero stat reveal
  • ✓Inside StatCard for animated value
  • ✓Dashboard KPI ribbons
  • ✓Marketing landing stats
Tags+6
animationnumbertickercount-upkpimotiondefault
Features+4
  • Spring physics (motion/react useSpring)
  • Formats: integer / currency / percent / decimal
  • Currencies: THB / USD / EUR / GBP / JPY with locale defaults
  • Sizes: default / compact / large
  • Tones: default / primary / success / warning / destructive
  • Prefix / suffix slots, custom decimals
Not recommended for−2
  • ✕Frequently-updating values (re-animating gets distracting)
  • ✕Inline body copy numbers

Install

Ask your agent, or call the MCP tool directly. The resolved bundle is written into your project.

get_registry_item({ name: "NumberTicker" })

Usage

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

<NumberTicker value={128440} format="currency" currency="THB" size="large" tone="primary" />

Tick variants in the left menu — each adds a tab with that variant’s real story source, the same code the preview above renders.

Props

PropTypeRequired
value

Target value

numberyes
format

Output format

'integer' | 'currency' | 'percent' | 'decimal'—
currency

Currency code

'THB' | 'USD' | 'EUR' | 'GBP' | 'JPY'—
size

Visual size

'default' | 'compact' | 'large'—
tone

Color tone

'default' | 'primary' | 'success' | 'warning' | 'destructive'—
duration

Animation duration in ms

number—

Every tonal component shares the same tone × emphasis API, so the pair looks identical across Button, Badge, Alert and more.

Related