Stat Trend Card

A single-metric KPI tile for a dashboard grid — big number, an auto-coloured up/down delta pill, and an optional inline sparkline so the direction reads at a glance. No chart library, pure inline SVG.

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

Install

velocityx add stat-trend-card

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

---
import StatTrendCard from '../components/velocity/stat-trend-card/StatTrendCard.astro';
---
<StatTrendCard />

Props

Prop	Type	Default	Description
label	string	required	—
value	string | number	required	—
delta	number	—	Signed percentage (or absolute) change. Sign decides the colour + arrow unless direction overrides it.
deltaLabel	string	—	Pre-formatted delta string, used instead of deriving one from delta (e.g. “+12.4%”).
deltaPeriod	string	—	—
direction	'up' | 'down' | 'flat'	—	—
trend	number[]	[]	—
icon	'astro' | 'none'	—	—
className	string	''	—

Files written

velocityx drops these into your project:

• components/velocity/stat-trend-card/StatTrendCard.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.