Stats & Numbers
Sparkline Stat
A value paired with a compact inline trend line — the pattern for a metric row where every figure needs its recent history at a glance. Hand-rolled SVG computed from a plain number array, no chart library, with an accessible text summary so the trend is never color-only.
$ velocityx add inline-sparkline-stat Built for astro.
Full docs for Sparkline Stat →
Needs a licence key —
subscribe here, then
velocityx loginonce.
Props
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| label | string | No | 'Weekly signups' | |
| value | string | No | '1,284' | Pre-formatted current value, e.g. "$48.2k". |
| points | number[] | No | [42, 48, 45, 61, 58, 70, 76] | The series the sparkline draws, oldest first. |
| delta | string | No | ||
| deltaDirection | 'up' | 'down' | 'flat' | No | Computed from the first/last point when omitted. | |
| periodLabel | string | No | 'the last 7 periods' | Used only in the accessible summary, e.g. "last 7 days". |
| className | string | No | '' |
File this creates
The CLI writes this path into your project, relative to its root — nothing else moves.
components/velocity/inline-sparkline-stat/InlineSparklineStat.astro Using the Sparkline Stat component
Install it with velocityx add inline-sparkline-stat.
The CLI writes the source straight into your project — no runtime dependency, no registry
lock-in, and it themes itself from the same primary-*/accent-* scale as the rest of the library.
Related components
More from Stats & Numbers.
Stat band whose numbers count up when the section scrolls into view, then settle. No runtime dependency — plain Astro plus a small inline observer. Honours prefers-reduced-motion by rendering final values immediately.
astroPuts two numbers on one shared scale and calls out the delta — the proof-point shape for 'we cut your load time' or 'conversion rate before vs. after' case studies. Ships a screen-reader summary alongside the bars, so the comparison reads correctly even without the visual.
astroOne 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.
astroThe compact way to show actual-vs-target on a scorecard row: a thin fill against a qualitative poor/satisfactory/good band, with a tick marking the target, so a whole KPI reads in the space a single number used to take. Values stay in text too, so it holds up for anyone who can't read the bar visually.
astro