Ballmac UI home

Progress Ring

A token-colored circular progress meter with a readable center and accessible value.

Almost ready

Complete your workspace setup.

Installation

$ pnpm dlx shadcn@latest add @ballmac/progress-ring

Usage

import { ProgressRing } from "@/components/ballmac/progress-ring"

The full example is in the Code tab above.

Examples

States and variants

API reference

PropTypeDefault
value*

Current progress value.

number—
max

Maximum value; defaults to 100.

number100
label*

Accessible name for the progress meter.

string—
size

Diameter in pixels.

number96
children

Center content, or the formatted percentage by default.

React.ReactNode—

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
NoneProgressbar name and current value are announced

Use with AI

A token-colored circular progress meter with a readable center and accessible value. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Progress Ring (@ballmac/progress-ring) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • Show bounded progress in a small area

Not for

  • Use Progress for a full-width track

Registry JSON: https://ui.ballmac.com/r/progress-ring.json

Credits

Free to use in personal and commercial projects.

npm
None
Registry
shadcn/utils