A shadcn-style progress circular component built with Ark UI primitives.

50%

Installation

npx shadcn@latest add @ark-cn/progress-circular

Usage

import * as ProgressCircular from "@/components/ui/progress-circular"

Read exported parts in src/components/ui/progress-circular.tsx and compose the primitive according to the Ark UI pattern for this component.

Examples

Default

50%

Min and max

1

Indeterminate

Label

Uploading files
72%

Root provider

useProgress + RootProvider value 36

External control
36%

Ring variant

45%

Thumb

64%

Controlled

42%

Controlled 42

API reference

This component mirrors the upstream Ark UI primitive. All props and DOM behavior are defined by Ark unless you see an ark-cn-only row below.

ProgressCircular

PropTypeDescription
variant?"labeled" | "ring" | "row"Layout variant.
footer?ReactNodeRenders below the ring.
label?ReactNodeOptional title above the ring.
showCenterValue?booleanOverlays value text in the center.
showThumb?booleanRenders a thumb on the ring.
size?numberOuter diameter in px (default 120).
thickness?numberStroke thickness (default 8).

See the ARK UI documentation for the full API.

Accessibility

See the Ark UI documentation for clarification.