1. Documentation
  2. Feedback
  3. Empty
ReadmenpmGitHub
  • Introduction
  • Installation
  • Theming
  • Icons
  • Accordion
  • Card
  • Scroll Area
  • Separator
  • Sidebar
  • Field
  • Label
  • Input
  • Textarea
  • Number Field
  • OTP Field
  • Select
  • Combobox
  • Checkbox
  • Radio
  • Switch
  • Slider
  • Toggle
  • Calendar
  • Date Picker
  • File Upload
  • Button
  • Copy Button
  • Dropdown
  • Command
  • Tabs
  • Breadcrumb
  • Pagination
  • Tree
  • Table
  • Data Table
  • Stat
  • Timeline
  • Avatar
  • Status Bar
  • Badge
  • Meter
  • Empty
  • Skeleton
  • Spinner
  • Toast
  • Dialog
  • Sheet
  • Popover
  • Tooltip
  • Text
  • Kbd
  • Code Block
  • Utilities
  • Design rules

Empty

The nothing-here state — left-aligned with a rule down its side, not a centred icon in a circle.

Loading documentation…

Meter< PreviousSkeletonNext >

Powered by heyo

On this page

UsageCentred, when centring is rightBorderedProperties

No workers yet

Deploy one and it will show up here with its logs and metrics.

Or run heyo deploy from your terminal.

<Emptyicon={IconCube}title="No workers yet"description="Deploy one and it will show up here with its logs and metrics."action={<Button variant="primary" icon={IconPlus}>Create worker</Button>}hint="Or run heyo deploy from your terminal."/>

Deliberately not a centred icon-in-a-circle over centred text. That layout reads as an error — it is the same composition as a 404 — and it puts the least useful element, a generic icon, at the optical centre.

Here the icon is a small mark on the same baseline as the title, the copy is left-aligned like every other paragraph in the product, and a rule runs down the side so the block sits in the layout instead of floating in a hole.

Usage

tsx
import { Empty } from "@heyo-sh/heyo-ui";<Empty  icon={IconInbox}  title="No notifications"  description="You are all caught up."/>;

Centred, when centring is right

align="center" exists for the one case that earns it: an entire empty page, with nothing else on screen to align to.

Nothing to see here

This project has no deployments.

<Emptyalign="center"borderedicon={IconMoodEmpty}title="Nothing to see here"description="This project has no deployments."action={<Button variant="outline">Read the guide</Button>}/>

Bordered

bordered draws a well around the block — for an empty pane or a drop target, where the boundary is part of the message.

No incidents

Nothing has paged anyone in 42 days.

<Emptyborderedicon={IconInbox}title="No incidents"description="Nothing has paged anyone in 42 days."/>
Empty, or filtered-empty?

"Nothing here yet" and "your search matched nothing" are different problems and deserve different words. DataTable takes both as empty and emptyFiltered.

Properties

titleReactNoderequired

What is missing.

descriptionReactNodeoptional

Why, or what to do about it.

iconIconLikeoptional

A small mark on the title's baseline.

actionReactNodeoptional

Usually a single Button, sometimes a primary plus a ghost.

hintReactNodeoptional

A muted footnote under the action — a doc link, a shortcut, a limit.

align"stack" | "center"optional

stack is the default: a left-aligned block with a rule down its side. center is for a whole empty page or pane.

borderedbooleanoptional

Draws a well around the block.

childrenReactNodeoptional

Extra content under the description, before the action.