Skip to main content
161

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
Android docs
FeedbackAndroid

Empty state

Explain missing content with supporting copy, an optional graphic, and a recovery action.

Public APILumenEmptyStateAndroid / Compose

Native example

Use Empty state

Explain why the state is empty and offer one useful next action when recovery is possible. Do not use for loading or error states.

Empty state rendered in the Android phone emulator Lumen playground
Verified runtime captureAndroid phone emulator
kotlin
LumenEmptyState(
    title = "No saved workspaces",
    description = "Create a workspace to get started.",
    actions = { LumenButton(onClick = ::createWorkspace) { Text("Create") } }
)

Reference

Public API

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

APIValues or typeDefaultDescription
titleStringRequiredNames the empty state.
graphic(@Composable () -> Unit)?nullProvides an optional platform-native supporting graphic.
descriptionString?nullExplains the state or next step.
actions(@Composable () -> Unit)?nullProvides optional recovery actions.

Native behavior

Design and accessibility

When to use it

Explain why the state is empty and offer one useful next action when recovery is possible. Do not use for loading or error states.

Accessibility

The title, description, optional graphic, and recovery actions remain in a readable native order.

Shared component

Available on other platforms

React NativeApple / SwiftUI
Android docsCompose module