Gauge

A circular progress gauge built with SVG. Animates from zero on mount using a spring easing curve and supports flexible sizing, custom colors, and an optional center label.

Import

import { Gauge } from "@animui/ui";

Basic

Render multiple gauges side by side at different fill levels.

25
Low
68
Medium
90
High

Sizes

Three size presets — sm, md, and lg — scale the SVG canvas and stroke width together.

60
Small
60
Medium
60
Large

Interactive

Drag the slider to update the gauge value live.

50
Progress
50%

Props

PropTypeDefaultDescription
valuenumberCurrent value to display.
maxnumber100Maximum value for the gauge.
size"sm" | "md" | "lg""md"Gauge size variant.
showValuebooleantrueShow the numeric value in the center.
labelstringCaption shown below the gauge.
colorstring"#7c3aed"Color of the progress arc.
trackColorstring"#e5e7eb"Color of the background track ring.
classNamestringAdditional classes.
© 2026 Steal Shadow. MIT License.Report an issue