Skip to main content
161

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
Apple docs
FeedbackApple

Wearable status

Show a compact, text-first semantic status on the wrist.

Public APILumenWatchStatusApple / SwiftUISwift product: LumenUI

Apple availability

Supported native targets

Import LumenUI in the target that uses this component. iPad support follows the iOS package baseline and uses native iPad layout behavior.

Apple Watch · watchOS 9+

Native example

Use Wearable status

Use for a short, high-value wrist status. Do not use a badge as the only representation of an urgent notification.

Wearable status rendered in the watchOS simulator Lumen playground
Verified runtime capturewatchOS simulator
swift
LumenWatchStatus("5-1-1", systemName: "cross.case.fill", tone: .danger)

Reference

Public API

The primary shared and platform-specific options exposed by LumenWatchStatus.

APIValues or typeDefaultDescription
titleNative localized textRequiredProvides concise status meaning.
tonebrand · accent · success · warning · danger · neutralneutralApplies semantic emphasis.
systemNameOptional native visualnilAdds a supporting wearable glyph.

Native behavior

Design and accessibility

When to use it

Use for a short, high-value wrist status. Do not use a badge as the only representation of an urgent notification.

Accessibility

Keeps status meaning in concise text instead of relying on semantic color alone.

Shared component

Available on other platforms

Android / Compose
Apple docsSwiftUI package