Skip to main content
161

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
React Native docs
FeedbackReact Native

Illustration

Render a built-in empty, success, error, or offline semantic scene.

Public APILumenIllustrationReact Native

Native example

Use Illustration

Use the built-in scene when its state matches the product message. Keep it decorative when the adjacent heading and description already communicate the same status.

View verified React Native runtime capture
Illustration rendered in the Expo web renderer Lumen playground
Verified runtime captureExpo web renderer
tsx
<LumenIllustration
  label="Saved successfully"
  variant="success"
/>

Reference

Public API

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

APIValues or typeDefaultDescription
variantempty · success · error · offlineemptySelects the semantic scene.
toneauto · brand · accent · neutralautoUses the state color automatically or an explicit portable tone.
sizesm · md · lgmdSelects the shared 96, 128, or 176 unit dimension.
labelstringundefinedOptionally exposes the illustration as one labeled image.

Native behavior

Design and accessibility

When to use it

Use the built-in scene when its state matches the product message. Keep it decorative when the adjacent heading and description already communicate the same status.

Accessibility

Illustrations are decorative by default; an optional label exposes the complete scene as one image.

Shared component

Available on other platforms

Apple / SwiftUIAndroid / Compose
React Native docsNative primitives