Semi-Circle Gauge Meter

A half-circle gauge with a trig-computed needle, a swept zone band and a worded verdict pill — never colour alone.

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

Install

velocityx add semi-circle-gauge-meter

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

---
import SemiCircleGaugeMeter from '../components/velocity/semi-circle-gauge-meter/SemiCircleGaugeMeter.astro';
---
<SemiCircleGaugeMeter />

Props

Prop	Type	Default	Description
value	number	required	Current value. Clamped into [0, max].
max	number	100	—
label	string	'Score'	—
valueText	string	—	Pre-formatted override for the centre value text, e.g. “82%”.
unit	string	''	—
zones	GaugeZone[]	[ { upTo: max * 0.33, verdict: 'Needs attention…	Ascending zone cutoffs with their worded verdicts. Defaults to a three-band poor/fair/good split of max.
className	string	''	—

Files written

velocityx drops these into your project:

• components/velocity/semi-circle-gauge-meter/SemiCircleGaugeMeter.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.