KB-111 · BEACON
Beacon
One capsule, every live activity — the shell morphs between timer, upload, call, and now-playing views with blur crossfades, corners pinned.
KB-111 · BEACON
Standby
▸ standby — tap the capsule to expand
Install
One command — the source lands in your repo. Or copy it from the Code tab.
$ pnpm dlx shadcn@latest add @kinetiq/beacon
Props
- activity
- BeaconActivity | null
- default —
- Discriminated union: timer (endsAt), upload (progress), call (accept/decline), playing (title/artist); null collapses to a standby pill.
- expanded / defaultExpanded / onExpandedChange
- boolean / boolean / (expanded) => void
- default —
- Controlled or uncontrolled detail row.
- onDismiss
- () => void
- default —
- Renders a dismiss action in the detail row.
| Prop | Type | Default | Description |
|---|---|---|---|
| activity | BeaconActivity | null | — | Discriminated union: timer (endsAt), upload (progress), call (accept/decline), playing (title/artist); null collapses to a standby pill. |
| expanded / defaultExpanded / onExpandedChange | boolean / boolean / (expanded) => void | — | Controlled or uncontrolled detail row. |
| onDismiss | () => void | — | Renders a dismiss action in the detail row. |