Button

Pin Toggle

A toggle with an icon and a stable caption: the caption stays the name of the action, and the result is announced by a live line under the button.

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 button name through label
  • the result text through onLabel
  • the initial state through defaultPressed

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

Preview

1440pxHost theme
Pin Toggle — A toggle with an icon and a stable caption: the caption stays the name of the action, and the result is announced by a live line under the button.

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/toggle-002?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

<Toggle002
  label="Pin"
  onLabel="Pinned to the top of the list"
  defaultPressed
/>

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

Settings

Caption
label · default: Pin
Result
onLabel · default: Pinned to the top of the list
Released state
offLabel · default: Not pinned
Pressed
defaultPressed · default: on
Accent
accent · default: theme colour
Background
background · default: theme colour

FAQ

How do I add Pin Toggle 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 Pin Toggle depend on?
No npm packages beyond React and Tailwind CSS.
What can I change in Pin Toggle?
Adapt: the button name through label; the result text through onLabel; the initial state through defaultPressed. Keep as installed: the local --vibeui-toggle-002-* palette — do not swap it for your theme tokens; the unchanging caption: an element's name must not change along with its state; the role="status" line under the button — it speaks the result the name cannot carry.
Is Pin Toggle 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/toggle-002.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

One file, zero dependencies, the --vibeui-toggle-002-* palette. Client-side: useState. The button caption does not change when pressed — only aria-pressed and the live role="status" line under it change. That is a deliberate decision: the caption is the button's name, and if it were rewritten to "Unpin", a screen reader would read the new name together with the state and produce "Unpin, pressed". The pressed state is shown by three cues at once — the filled icon (fill:currentColor on the path), the background and the word in the line — because one colour is not read by everyone. Unlike a switch, the action applies instantly and to a specific object.

Tags

  • toggle
  • aria-pressed
  • pin
  • icon
Component source

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

Loading…