Count-Up Metric with Delta Badge

A single large figure that counts up the moment it scrolls into view, paired with a directional change badge. No chart library, no runtime dependency — locale-safe number formatting and a permanent screen-reader value so the real number is never hidden behind the animation.

Stats & Numbers · Astro · Subscription · commercial licence · v1.0.1 · updated 2026-10-15 · Live demo

Install

velocityx add count-up-delta-stat

Subscription component. Run velocityx login with your key first — get one.

---
import CountUpMetric from '../components/velocity/count-up-delta-stat/CountUpMetric.astro';
---
<CountUpMetric />

Props

Prop	Type	Default	Description
label	string	'Monthly recurring revenue'	—
value	number	48200	The number to count up to.
decimals	number	0	Decimal places to render, e.g. 1 for “4.2”.
prefix	string	''	—
suffix	string	''	—
duration	number	1400	Count-up duration in ms.
delta	string	'12.4%'	—
deltaDirection	'up' | 'down' | 'flat'	'up'	—
className	string	''	—

Files written

velocityx drops these into your project:

• components/velocity/count-up-delta-stat/CountUpMetric.astro

Peer dependencies

None.

Theming

Colours come from the primary-* / accent-* Tailwind scales, so this drops into a project that is not Velocity without dragging our brand in. Install the contract once:

velocityx theme

Then set your whole brand in one place — raw RGB channels, not hex (a hex here silently breaks every opacity variant):

:root {
  --vx-brand: custom;
  --vx-primary-600: 220 38 38;
}

There is no component-level font-family anywhere in the library — your font cascade wins.

Licence

Commercial, for the duration of an active Velocity X subscription. The source is served by the licence-gated endpoint, never by the public CDN.