Skip to content
VenusUI
Get started

Progress Ring

Circular progress with the value in the middle, exposed as an accessible progress bar.

Preview

Installation

npx shadcn@latest add @venusui/progress-ring

Run this in a project set up with shadcn. If you haven’t set it up yet, run npx shadcn@latest init first.

Files added to your project

Paths use the default shadcn aliases. The CLI follows the aliases in your components.json.

  • @/components/ui/progress-ring.tsx

Usage

The code behind the preview above.

progress-ring-demo.tsx

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

export default function ProgressRingDemo() {
  return (
    <div className="flex items-center gap-8">
      <ProgressRing value={72} label="Upload progress" />
      <ProgressRing value={3} max={5} size={72} strokeWidth={6} label="Onboarding steps completed">
        3/5
      </ProgressRing>
    </div>
  )
}

API reference

PropTypeDefaultDescription
valuenumber—Current progress, from 0 to max. Required.
maxnumber100Value at which the ring is full.
sizenumber96Diameter in pixels.
strokeWidthnumber8Ring thickness in pixels.
labelstring—Accessible name, e.g. “Upload progress”. Required.
childrenReactNodepercentageContent in the middle, e.g. 3/5.

All <div> props except children, which is listed above.

Requirements

  • Tailwind CSS v4, with a cn helper at @/lib/utils. Works in Server Components.

Customization

  • Color the ring with stroke classes: it uses stroke-primary (your theme’s primary color); edit it in the file, or pass className="[&_circle:last-child]:stroke-emerald-500".
  • Show steps instead of percent with max={5} and children="3/5".

Accessibility

  • Uses role="progressbar" with min, max and current value, so screen readers announce progress.
  • The ring animates between values unless the user prefers reduced motion.

Troubleshooting

The ring starts at the right instead of the top.
The SVG is rotated -90deg to start at 12 o’clock. Keep the -rotate-90 class.
Unknown registry "@venusui"
Your shadcn CLI couldn’t find the namespace in the shadcn registry index. Use the latest CLI (npx shadcn@latest), install by URL, or register it with its address: npx shadcn@latest registry add @venusui=https://venusui.com/r/{name}.json.
No components.json found
Run npx shadcn@latest init in your project first.
Loading preview

Bar Loader

Loaders

A thin indeterminate progress bar for pages and cards that are loading.

Loading preview

Three dots that rise and fall in turn, for typing or inline loading states.

Loading preview

Scroll Progress

Navigation

A thin bar that fills as the reader scrolls through a page or container.