Stepkit/Empty state
Patterns · Original

Empty state

A useful first-run moment with a clear next action.

Download ZIP
Live preview

Try it in context

Customize preview
Source delivery

Usage & source

v0.3.0
React
"use client";

import type { CSSProperties } from "react";
import { EmptyState } from "./components/stepkit/EmptyState";
import "./components/stepkit/styles.css";

const themeStyle = {"--stepkit-bg":"#f7f7f8","--stepkit-surface":"#ffffff","--stepkit-surface-muted":"#f0f0f3","--stepkit-fg":"#17181c","--stepkit-muted":"#626572","--stepkit-border":"#e3e4e9","--stepkit-border-strong":"#c8cad3","--stepkit-code":"#f1f1f4","--stepkit-shadow":"0 20px 60px rgba(31, 26, 64, .10)","--stepkit-accent":"#6950df","--stepkit-accent-strong":"#5137c7","--stepkit-accent-soft":"#eeeafd","--stepkit-accent-on-soft":"#5137c7","--stepkit-accent-text":"#ffffff","--stepkit-error":"#b43145","--stepkit-placeholder":"#626572","--stepkit-radius":"16px","--stepkit-space":"16px","--stepkit-control-height":"44px","--stepkit-font-sans":"Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif"} as CSSProperties;

export default function Example() {
  return (
    <div className="stepkit-theme" data-stepkit-preset="modern" style={themeStyle}>
      <EmptyState
      title={"Nothing here yet"}
      description={"Start with a small action and this space will take shape."}
      actionLabel={"Create first"}
      />
    </div>
  );
}

Dependencies

[email protected]
[email protected]
Add to your project

Install

Use the registry command or download the complete source archive.

npx [email protected] add https://vstepanov.com/stepkit/archive/v0.3.0/r/empty-state.json
Assistant handoff

Integration prompt

Prompt
Install Stepkit Empty state 0.3.0 from the registry and preserve the included MIT notice.
npx [email protected] add https://vstepanov.com/stepkit/archive/v0.3.0/v0.3.0/r/empty-state.json
Install the tested runtime dependencies exactly: npm install [email protected] [email protected]
Keep the component source, shared styles, NOTICE.md, and provenance files together. Apply the theme tokens on a wrapper rather than passing theme keys as component props.

Usage:
```tsx
"use client";

import type { CSSProperties } from "react";
import { EmptyState } from "./components/stepkit/EmptyState";
import "./components/stepkit/styles.css";

const themeStyle = {"--stepkit-bg":"#f7f7f8","--stepkit-surface":"#ffffff","--stepkit-surface-muted":"#f0f0f3","--stepkit-fg":"#17181c","--stepkit-muted":"#626572","--stepkit-border":"#e3e4e9","--stepkit-border-strong":"#c8cad3","--stepkit-code":"#f1f1f4","--stepkit-shadow":"0 20px 60px rgba(31, 26, 64, .10)","--stepkit-accent":"#6950df","--stepkit-accent-strong":"#5137c7","--stepkit-accent-soft":"#eeeafd","--stepkit-accent-on-soft":"#5137c7","--stepkit-accent-text":"#ffffff","--stepkit-error":"#b43145","--stepkit-placeholder":"#626572","--stepkit-radius":"16px","--stepkit-space":"16px","--stepkit-control-height":"44px","--stepkit-font-sans":"Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif"} as CSSProperties;

export default function Example() {
  return (
    <div className="stepkit-theme" data-stepkit-preset="modern" style={themeStyle}>
      <EmptyState
      title={"Nothing here yet"}
      description={"Start with a small action and this space will take shape."}
      actionLabel={"Create first"}
      />
    </div>
  );
}
```

Selected bounded settings: {"title":"Nothing here yet","description":"Start with a small action and this space will take shape.","actionLabel":"Create first"}.
Selected theme: {"mode":"light","accent":"violet","radius":"soft","density":"comfortable","preset":"modern"}.
API

Props

NameTypeDefaultDescription
titlestring"Nothing here yet"Heading.
descriptionstring"Start with a small action and this space will take shape."Supporting copy.
onAction() => voidundefinedAction callback.
Quality

Accessibility & limits

  • Uses a labelled section and native button.
  • The decorative icon is hidden from assistive technology.

Limitations

  • The icon is text-based so consumers can replace it with their own slot.
Source record

Provenance

Original source under the MIT licence.

Original Stepkit implementation.

Required notices: NOTICE.md, PROVENANCE-stepkit-empty-state.md