Sstepkit
patterns · Original · MIT

Empty state

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

Live preview

Adjust a setting to update the preview and usage code together.

Usage & source

"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]

Install

Use the released registry entry or download the complete archive.

npx [email protected] add https://vstepanov.com/stepkit/r/empty-state.json

Integration prompt

Install Stepkit Empty state 0.2.0 from the registry and preserve the included MIT notice.
npx [email protected] add https://vstepanov.com/stepkit/v0.2.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"}.

Props

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

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.

Provenance

Original source under the MIT licence.

Original Stepkit implementation.

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

  • 3 source files in the release
  • Version 0.2.0