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

1440pxHost theme
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.

Use it with AI

  1. 1. Copy the link.
  2. 2. Write to your agent in your own words and drop the link into the sentence.
  3. 3. The agent opens the link and installs the component from the registry.
AI
1Pick it here

put this on the home page as the hero:

https://vibeui.club/c/spinner-004?lang=en&theme=dark

2Paste into the chat
3Get it in your project

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

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.json

This 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…