Avara UI

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

npx shadcn@latest add https://avaraui.com/r/live-pulse-pill.json

components/custom/blocks/LivePulsePillBlock.tsx 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.

npx shadcn@latest add https://avaraui.com/r/button.json https://avaraui.com/r/modal.json

Props Reference

PropTypeDefaultDescription
variant"default" | "pulse""default"

Visual style variant for the live presence pill.

participantsLiveParticipant[]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.

countnumber | string"+4"

The trailing badge text or number displayed on the right side of the pill.

titlestring"Live Session"

The header title shown inside the pop-up modal dialog.

actionLabelstring"Join Now"

Text for the full-width action button at the bottom of the modal.

onJoin() => voidundefined

Callback triggered when the user clicks the action button inside the modal.

disableModalbooleanfalse

When set to true, clicking the pill will not open the modal.

themeColorstringundefined

Color override applied to the soundwave badge, pulse ring, and modal elements (e.g. "hsl(var(--primary))" or hex code).