sigilUI

Usage Gauge

A semicircular gauge for displaying resource usage with auto-color thresholds.

@sigil-ui/componentsReact

Preview

Live preview Interactive

Import

import { UsageGauge } from "@sigil-ui/components";

Usage

<UsageGauge value={78} max={100} label="CPU" unit="%" autoColor />

Props

PropTypeDefaultDescription
valuenumber—Current value
maxnumber100Maximum value
labelstring—Label below percentage
unitstring—Unit shown on scale ends
widthnumber160SVG width
heightnumber120SVG height
colorstring—Override arc color
autoColorbooleantrueAuto-color: primary below 70%, warning 70-90%, error above 90%

Token integration

CSS VariablePurpose
--s-primaryNormal usage arc color
--s-warningWarning threshold color (>70%)
--s-errorCritical threshold color (>90%)
--s-borderTrack background
--s-textPercentage value
--s-text-mutedLabel and scale text
--s-font-monoValue font family