Big Number Hero Stat

One headline figure sized to carry a section on its own, with a short annotation line underneath for context. Locale-safe number formatting (including compact ‘4.2M’ notation) and a count-up that lands on the real value immediately for reduced-motion users.

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

Install

velocityx add big-number-stat

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

---
import BigNumberStat from '../components/velocity/big-number-stat/BigNumberStat.astro';
---
<BigNumberStat />

Props

Prop	Type	Default	Description
value	number	required	—
prefix	string	''	—
suffix	string	''	—
compact	boolean	false	Uses Intl compact notation (4.2M) instead of the full number.
decimals	number	compact ? 1 : 0	Decimal places to keep, applies to both compact and full formatting.
label	string	required	—
annotation	string	—	—
align	'left' | 'center'	'left'	—
size	'md' | 'lg'	'lg'	—

Files written

velocityx drops these into your project:

• components/velocity/big-number-stat/BigNumberStat.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.