Skip to content
Back

Empty statesPro

A useful next step when there is nothing to show: first run, no results, no runs, inbox zero, offline, error and no access.

oxyn add empty-states
No projects yet
Create a project to give your agents a repository, tools and rules.
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

  • A next step when there is nothing to show: first run, no results, no runs, inbox zero, offline, error, no access.

When not to use

  • A small turning arc for work that runs right now, plus dots, ray and orbit styles: use Spinner instead.
  • The empty state of an AI app: use Starter prompts instead.
  • Fourteen text-glyph loaders (braille, sand, blocks, scanner…) that settle into a check, a warning or a cross when the agent finishes, waits or fails: use Glyph loader instead.

Installation

Empty states 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-states

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

First run

Nothing created yet.

No projects yet
Create a project to give your agents a repository, tools and rules.
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

No results

A search that matched nothing.

No results for “flaky auth”
Check the spelling or try a broader term. Filters may be hiding matches.
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

Offline

Offline.

You're offline
Changes are kept on this device and sync when the connection comes back.
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

Starter

First run with starter prompts (Oxyn plus).

No projects yet
Create a project to give your agents a repository, tools and rules.
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 list.

You're all caught upNo approvals or mentions waiting. New ones appear here as agents work.
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

EmptyPreset

PropTypeDefaultDescription
presetString"first-run"Preset id.
queryStringDefault::default()Query for no-results.
layoutString"framed"`framed` · `bare` · `inline`.
promptsVec<String>Default::default()Starter prompts (first-run).
on_actionEventHandler<()>—Primary action.

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 actions

Accessibility

  • role=status with a title; the icon is aria-hidden.
  • Copy changes roll in place.
From the spec

role=status with the title; the icon is decorative.

Motion & interaction

Changing preset rolls the block in place (rise + fade); the icon tile pops.

Timing
TransitionDurationEasingReduced motion
Roll280 msease.outinstant

Responsive behaviour

  • Centred up to 520px.
Edge cases (spec)

No-results reflects the query. Long text wraps up to 520 px.

Notes for AI

  • Import EmptyPreset, 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