Search documentation

Search guides, examples, and component APIs.

Quick links
↑↓ NavigateEnter OpenEsc Close
Get started

Blocks / Messaging & activity

Live status island

A floating panel for a running activity (music, a call, or a timer) that expands into its controls and settles back with a spring.

bunx --bun @getweini/cli@latest add button card island progress toggle-group
Customize
  • Island keeps one running activity visible. The compact row holds an icon, a title, and a ticking clock; the expanded region holds the controls. Switching the activity re-creates the panel so it always starts collapsed unless you pass `expanded`.
  • Pick the activity with the `activity` prop and handle the controls through the `action` event, which reports the activity and the action name (`pause`, `mute`, `stop`, and so on). The block owns no media or call logic.
  • The clock starts after mount, so server and client render the same first frame. Replace the interval with your own time source; the progress bars take plain 0 to 100 values.
  • Keep the compact content phrasing-only (spans and decorative icons), because it lives inside a button. Controls go in the `expanded` slot. Escape collapses the panel and returns focus to it.
  • Resize the panel with `--ui-island-compact-size` and `--ui-island-expanded-size` on a parent. All text lives in the `copy` prop.