Skip to content

Empty StatePro

What a list or panel shows while it has nothing yet: an icon, a title, one line and a first step, framed, bare or inline, with starter prompts for agent apps.

oxyn add empty-state
No runs yet
Start an agent on this repo and its runs show up here.
The code is part of Oxyn Pro

The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.

Get Pro

Rendered from Rust at build time · goes live when visible

When to use

  • What a list or panel shows while it has nothing yet: an icon, a title, one line and a first step, framed, bare or inline, with starter prompts for agent apps.

When not to use

  • A small label for one control: use Tooltip instead.
  • Actions and choices behind any trigger: use Dropdown Menu instead.
  • The empty state of an AI app: use Starter prompts instead.

Installation

Empty State is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.

Terminal
oxyn add empty-state

Usage

Dioxus · rust
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Examples

Framed

Dashed frame and prompts.

No runs yet
Start an agent on this repo and its runs show up here.
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Bare

No frame.

No runs yet
Start an agent on this repo and its runs show up here.
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Inline

One line in a table.

No runs yetStart an agent on this repo and its runs show up here.
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

API reference

EmptyState

PropTypeDefaultDescription
staterequiredEmptyModel—Model.
on_actionEventHandler<()>—Primary action.
on_secondaryEventHandler<()>—Secondary action.
on_promptEventHandler<String>—A starter prompt was picked.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
TabTo the action, the link and each prompt

Accessibility

  • Title and text are plain text in reading order; the action and prompts are real buttons.

Responsive behaviour

  • Framed and bare centre in their container; inline fits inside a table row.

Notes for AI

  • Import EmptyState from oxyn_dioxus and include PRIMITIVES_CSS plus the token stylesheet once.
  • A GPUI version exists: EmptyStateEl in oxyn_gpui.
  • Props to set first: state.
  • Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.

Guides

Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI