Bullet Chart KPI

The 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.

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

Install

velocityx add bullet-chart-kpi

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

---
import BulletChartKpi from '../components/velocity/bullet-chart-kpi/BulletChartKpi.astro';
---
<BulletChartKpi />

Props

Prop	Type	Default	Description
label	string	'Revenue (Q3)'	—
value	number	275	—
target	number	250	—
max	number	—	Upper bound of the scale. Defaults to the highest range step.
ranges	number[]	[100, 200, 300]	Ascending breakpoints for the qualitative band, e.g. [100, 200, 300].
rangeLabels	string[]	['Poor', 'Satisfactory', 'Good']	—
formattedValue	string	—	Pre-formatted override for the value display, e.g. “$275k”.
formattedTarget	string	—	Pre-formatted override for the target display, e.g. “$250k”.
unit	string	''	—
locale	string	'en-US'	—
className	string	''	—

Files written

velocityx drops these into your project:

• components/velocity/bullet-chart-kpi/BulletChartKpi.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.