ProgressCircle
Metrics & Status

ProgressCircle

Ring gauge for compact percent readouts such as batch completion, quota, or risk scores. Renders the rounded percentage in the center by default.

Props

ProgressCircle extends HTMLAttributes<HTMLDivElement>. Renders as role="progressbar".

ProgressCircleProps props
PropTypeDefaultDescription
valuenumber—Fill percentage, 0–100.
sizenumber44Overall width/height in px.
strokeWidthnumber4Ring thickness.
toneProgressTone"primary""primary" | "ok" | "warn" | "err".
childrenReactNode—Center content. Defaults to the rounded percentage. Pass null to hide it.

Examples

Tone variants

ProgressCircle tones

With custom center content

ProgressCircle custom center

Different sizes

ProgressCircle sizes
ImportTSX
import { ProgressCircle } from "@solarius/onset";
import type { ProgressCircleProps, ProgressTone } from "@solarius/onset";