Shadcn Live Pulse Pill
An interactive live presence pill with an animated soundwave pulse and modal participant roster for active calls, streams, audio spaces, and huddles.
Clicking the pill triggers a smooth pop-up modal displaying active session participants, real-time speaker badges, and a direct action trigger.
Live Pulse Pill
Interactive presence pill with pulsating soundwave icon, overlapping avatar stack, and centered session participant modal.
variant"default"- renders the live pulse pill with expanding ambient soundwave waves and avatar stack.
participantsPARTICIPANTS- array of active session participants shown in the pill and modal grid.
Installation
New project? Follow the installation guide to set up Tailwind CSS, shadcn, the cn helper and lucide-react, register the @avara-ui registry once, then copy your styles from the Themes page.
Install Live Pulse Pill
components/ is written into your project. Copy any snippet from a Usage tab above and it runs.
Install dependencies
Step 1 installs these for you. Run them yourself only if you are adding Live Pulse Pill to an existing project by hand. The cn helper and lucide-react are not listed — the installation guide covers them once for every component.
button and modal are components, not packages — the shadcn CLI installs them as source files.
Props Reference
| Prop | Type | Default | Description |
|---|---|---|---|
variant | "default" | "pulse" | "default" | Visual style variant for the live presence pill. |
participants | LiveParticipant[] | DEFAULT_LIVE_PARTICIPANTS | Array of participants to display. The first 4 appear in the pill's overlapping avatar stack, and all 8 appear inside the modal. |
count | number | string | "+4" | The trailing badge text or number displayed on the right side of the pill. |
title | string | "Live Session" | The header title shown inside the pop-up modal dialog. |
actionLabel | string | "Join Now" | Text for the full-width action button at the bottom of the modal. |
onJoin | () => void | undefined | Callback triggered when the user clicks the action button inside the modal. |
disableModal | boolean | false | When set to |
themeColor | string | undefined | Color override applied to the soundwave badge, pulse ring, and modal elements (e.g. |