Skip to Content
zjkm-ui
Components

Circular Progress

A ring that fills to its value.

Props
72
96px
<CircularProgress label="Storage used" value={72} />

Installation

npx shadcn@latest add https://ui.zjkm.tech/r/circular-progress.json
import { CircularProgress } from "@/components/circular-progress"

Using JavaScript? Set tsx: false in components.json and the CLI converts it.

New to shadcn? Run npx shadcn@latest init first. The CLI needs components.json and the @/ import alias.

Usage

A ring that fills to its value, with the percentage in the middle. Good for compact spaces like cards and dashboards.

import { CircularProgress } from "@/components/circular-progress";

export function Storage({ used, quota }: { used: number; quota: number }) {
  return <CircularProgress label="Storage used" value={used} max={quota} />;
}

Props

PropTypeDefaultDescription
valuenumberProgress so far.
maxnumber100The total.
labelstringAccessible name.
sizenumber96Diameter in pixels.
thicknessnumber8Ring width in pixels.
colorstring"#6366f1"Ring colour.
classNamestringClasses for the wrapper.

With reduced motion, the ring jumps to each value.

On this page