Loading
Percent Ring Meter
A progress ring with the percentage inside. Suits a file upload or a long operation. Change the percentage, the size and the ring colour.
React + Tailwind, shadcn-compatible: press “Copy for AI” and your Cursor or Claude Code agent installs it with the shadcn CLI.
What you can change
- the share through value from 0 to 100
- the action caption through label
- the ring size through size: sm, md or lg
A link for your AI agent: preview, code and instructions.
Preview

Use it with AI
- 1. Copy the link.
- 2. Write to your agent in your own words and drop the link into the sentence.
- 3. The agent opens the link and installs the component from the registry.
put this on the home page as the hero:
https://vibeui.club/c/spinner-004?lang=en&theme=dark
Not sure where to paste it? Step-by-step guide
Show the full instructions
What the link says, spelled out. Use it when your agent cannot open links — paste this text instead.
Loading…
How to use
<Spinner004 value={68} label="Loading components" size="md" />A sample call. The agent installs the component itself from the registry via the “Copy for AI” link.
Settings
- Value, %
value· default: 68- Caption
label· default: Loading components- Size
size· default: md- Second line
hintTemplate· default: {value} of 100 done- Background
background· default: theme colour
More in Loading
FAQ
- How do I add Percent Ring Meter with Cursor or Claude Code?
- Press “Copy for AI” on this page and paste it into your agent's chat. The instruction contains the shadcn CLI install command, the dependencies and what to keep, so the agent installs this exact component instead of recreating a lookalike.
- What does Percent Ring Meter depend on?
- No npm packages beyond React and Tailwind CSS.
- What can I change in Percent Ring Meter?
- Adapt: the share through value from 0 to 100; the action caption through label; the ring size through size: sm, md or lg. Keep as installed: the local --vibeui-spinner-004-* palette — do not swap it for your theme tokens; the number layered above the ring as its own node: inside the masked element the mask would cut the digits too; the radial mask instead of a cover circle — a cover gives itself away on anything but a flat background.
- Is Percent Ring Meter free?
- Yes. The preview is open without an account; with a free account you can copy up to 20 components a month.
For developers
npx shadcn@latest add https://vibeui.club/r/pro/spinner-004.jsonThis command needs a signed link: sign in and open “Component source” below — it issues a working link valid for 30 minutes. All install options
Technical notes
A server component, there are no hooks. The arc is a conic-gradient with a radial mask cutting out its middle: that keeps the ring a single element, with no svg and no second circle covering the centre. The number lies above the ring as a node of its own rather than inside the masked element, otherwise the mask would cut the digits too. The value is clamped to 0–100 inside the component and declared through role=progressbar with aria-valuenow, valuemin and valuemax. The figures are tabular: with proportional ones "11 %" and "88 %" differ in width, and the caption jitters on every update. The theme comes from the surrounding color-scheme through light-dark(): the component has no background by default — it sits on the page background and darkens with it, while the background prop switches on a panel.
Tags
- spinner
- progress
- ring
- percent
Component source
The same file your agent installs. Here in case you would rather copy it by hand.
Loading…