Skip to content
Design System
GitHub

Dynamic island

v0.22.1Beta

Name, device status and notifications, each zone expanding on its own; notices and the most urgent unacknowledged alarm live inside the island.

API reference

Generated from the types. Every part also takes className.

Island

namerequired
string
avatar
ReactNode
status
"active" | "normal" | "warning" | "danger" | "offline"Shape at the avatar's corner: the dog's current state.
tone
"info" | "success" | "warning" | "danger" | "neutral"
attention
booleanAnother dog needs attention: a triangle after the name. Show it only for new issues.
online
boolean = true
battery
number = 72
charging
boolean
unread
number = 0
open
"name" | "status" | "bell" = nullWhich zone is expanded. Each zone has its own panel.
onOpenChange
(zone: Zone | null) => void
edge
"info" | "success" | "warning" | "danger" | "neutral"Persistent fault (stopped): changes the tray edge colour. Offline is neutral: say it, do not colour it.
loading
booleanStatus zone while the first status has not arrived.
children
ReactNodeIslandNotice or a panel.
labels
Partial<IslandLabels>

IslandNotice

tonerequired
"info" | "success" | "warning" | "danger" | "neutral"
iconrequired
ElementType
titlerequired
string
meta
string
action
{ label: string; onClick: () => void; }
persistent
booleanOffline, stopped: no close button, stays until the state changes.
emphasis
booleanSevere events and failures use a danger tint and do not auto-dismiss.
onDismiss
() => void
dismissLabel
string = "Dismiss"

IslandAlarm

alarmsrequired
AlarmData[]
onAcknowledge
(id: string) => void
onShowAll
() => voidOpens the full alarm list. Shown when more than one alarm is unacknowledged.
labels
Partial<AlarmLabels> & { more?: (n: number) => string; moreAlarms?: string; many?: (n: number) => string; }
feedback
boolean = trueBuzz and sound for a new critical or high alarm, and repeat critical until acknowledged. On by default: on a phone the island is the alarm surface. Turn off if an AlarmList on the same screen already signals.