# Chart Gauge KPI

Service availability (SLA) against breach bands.

- id: `chart-gauge-kpi`
- Page: https://agentic-ui-kit.com/components/chart-gauge-kpi
- Live preview: https://agentic-ui-kit.com/live/component/chart-gauge-kpi

## Install

```bash
agentic-ui add chart-gauge-kpi
npx shadcn@4.17.0 add @agentic-ui/chart-gauge-kpi
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** threshold-bands, target-marker, delta-indicator, value-readout, loading-state, error-state, empty-state, keyboard-activation
- **Intents:** track-status
- **Suits domains:** operations, saas, analytics, finance
- **Interaction:** click-select, keyboard-activation, value-readout
- **Screen role:** overview
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** service availability (SLA) against breach bands, cluster utilization where the high end is saturation, error budget consumed in the quarter, CSAT/NPS with detractor, passive and promoter bands
- **Avoid when:** comparing several series or evolution over time (use timeseries), composition by category (use bars or a donut), the scale has no actionable thresholds and a stat card is enough
- **Preserve when adapting:** threshold-band-semantics, keyboard-contract, meter-aria-contract, state-triad-loading-error-empty
- **Replace when adapting:** domain-copy, scale-and-units, band-definitions, value-formatting
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 8.9/10
- **Quality breakdown:** visual 8/10, responsive 9/10, accessibility 9/10, code 9/10
- **Motion:** profile subtle, library css, reduced-motion fallback yes
- **Used in:** Marketing Analytics (blueprint)