VibeUI
РусEng
Sign in
All1346Button124Input99Select40Card145Table33Dialog39Tabs14Badge33Avatar54Toast25Accordion32Alert35Button group77Calendar48Carousel28Chart36Checkbox & toggles59Code Block31Combobox62Command15Device Mockup10Dropdown menu32Empty20Loading32Navigation48Popover39Slider20Specialized inputs64Stepper29Tree19Typography4

Specialized inputs

Percent Guard

A percent input that will not silently clamp 150 to 100: the wrong number stays in the field, gets highlighted and explained in words.

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

  • label — the field caption
  • defaultValue — the starting percent
  • error — the error text under the field

A link for your AI agent: preview, code and instructions.

Preview

1440pxHost theme
Percent Guard — A percent input that will not silently clamp 150 to 100: the wrong number stays in the field, gets highlighted and explained in words.

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/number-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

<Number004 label="Discount share" defaultValue={15} error="A percent only goes from 0 to 100." />

A sample call. The agent installs the component itself from the registry via the “Copy for AI” link.

Settings

Label
label · default: Discount share
Percent
defaultValue · default: 15
Error text
error · default: A percent only goes from 0 to 100.
Accent
accent · default: theme colour
Background
background · default: theme colour

More in Specialized inputs

FAQ

How do I add Percent Guard 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 Guard depend on?
No npm packages beyond React and Tailwind CSS.
What can I change in Percent Guard?
Adapt: label — the field caption; defaultValue — the starting percent; error — the error text under the field. Keep as installed: the local --vibeui-number-004-* palette — do not swap it for your theme tokens; light-dark() in the palette: the component has to follow the surrounding color-scheme rather than ship a dark theme of its own; the transparent background by default — the component sits on the page background instead of laying a panel under itself.
Is Percent Guard 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/number-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

The component is self-contained: one file, zero dependencies, the palette in the local --vibeui-number-004-* variables. Client-side: the value and the error flag live in state. The input is stored as a string, so an in-progress empty field does not turn into zero. Going outside 0–100 is not corrected automatically: it is marked with data-invalid on the root, aria-invalid on the field and text in an aria-live region. The bar under the field shows the share as an area — a percent reads faster that way than as a digit.

Tags

  • number
  • percent
  • validation
  • form
Component source

The same file your agent installs. Here in case you would rather copy it by hand.

Loading…