KQ-910 · RINGTONE/PULSE

Ringtone Pulse

Someone is calling, announced by light: this ringtone is a visual pulse and plays nothing. While the call is live, rings expand from the caller's procedural disc and fade on a repeating tween a third of a cycle apart, gated on document visibility so a hidden tab rings at nobody. Decline slides in from the left and Answer from the right on snap, a cascade(2) beat apart, because the choice should look like the choice; answering swaps the body to a connected line at a ResizeObserver-measured height, and Escape declines.

KQ-910 · RINGTONE/PULSE

Ines Moreau

ringing · ines moreau · coldbrook dispatch

Install

One command — the source lands in your repo. Or copy it from the Code tab.

$ pnpm dlx shadcn@latest add @kinetiq/ringtone-pulse

Props

callerName: string; default —; Who is calling; drives the procedural initials and every sentence.
roomName: string; default —; The room the call comes from, printed under the name.
status / defaultStatus: "ringing" | "answered" | "declined" | "missed"; default "ringing"; The card's state, controlled or initial.
onStatusChange: (status: RingtoneStatus) => void; default —; Fires from Answer, Decline and Escape.
onAnswer: () => void; default —; Fires from the Answer control.
onDecline: () => void; default —; Fires from the Decline control and from Escape.
rings: number; default 3; Expanding rings behind the disc.
label: string; default —; Names the card for assistive technology; defaults to the calling sentence.

Prop	Type	Default	Description
callerName	string	—	Who is calling; drives the procedural initials and every sentence.
roomName	string	—	The room the call comes from, printed under the name.
status / defaultStatus	"ringing" \| "answered" \| "declined" \| "missed"	"ringing"	The card's state, controlled or initial.
onStatusChange	(status: RingtoneStatus) => void	—	Fires from Answer, Decline and Escape.
onAnswer	() => void	—	Fires from the Answer control.
onDecline	() => void	—	Fires from the Decline control and from Escape.
rings	number	3	Expanding rings behind the disc.
label	string	—	Names the card for assistive technology; defaults to the calling sentence.