Ballmac UI home

Progress

A Radix progress bar with clamped values, optional percentage text, and a reduced-motion-safe pending state.

Importing your filesStep 3 of 4

Organizing 48 documents into your workspace

68%

Installation

$ pnpm dlx shadcn@latest add @ballmac/progress

Usage

import { Progress } from "@/components/ballmac/progress"

The full example is in the Code tab above.

Examples

States and variants

Almost there
91%
Waiting for a response
In progress

API reference

PropTypeDefault
showValue

Show the value in a label below the bar.

booleanfalse

Also accepts the standard attributes of its root element.

Use with AI

A Radix progress bar with clamped values, optional percentage text, and a reduced-motion-safe pending state. With the shadcn MCP server set up (guide), ask your agent:

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

Use it for

  • Show completion of a bounded task
  • Show work in progress when completion is unknown

Not for

  • Use a spinner for very short waits

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

Credits

Based on shadcn/ui Progress, adapted by Ballmac. Free to use in personal and commercial projects.

Registry
shadcn/utils