Ballmac UI home

Pulse Button

A call-to-action button that sends soft rings outward to ask for attention, calming as soon as it is hovered or focused, and switchable off once the person acts.

Installation

$ pnpm dlx shadcn@latest add @ballmac/pulse-button

Usage

import { PulseButton } from "@/components/ballmac/pulse-button"

The full example is in the Code tab above.

Examples

Tones and states

API reference

PropTypeDefault
tone

Color of the rings.

PulseTone"primary"
rings

How many rings leave the button, one after another.

number2
duration

Seconds one ring takes to fade out.

number2
active

Turn the pulse off, for example once the person has acted.

booleantrue
wrapperClassName

Classes for the wrapper around the button and rings.

string—

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
Enter / SpaceActivates like any button
Screen readersRings are aria-hidden
Reduced motionA still faint ring replaces the pulse

Use with AI

<PulseButton tone rings duration active>Label</PulseButton>. Rings stop on hover and focus, and when active is false or the button is disabled. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Pulse Button (@ballmac/pulse-button) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • Onboarding steps and 'try it now' prompts
  • Live or record buttons

Not for

  • More than one per view
  • Anything permanent: attention fades if it never stops

Registry JSON: https://ui.ballmac.com/r/pulse-button.json

Credits

Free to use in personal and commercial projects.