Available · v0.1.0
Empty state
Explain missing data and offer one useful next action.
Interactive example
Usage
<EmptyState title="Your companies will appear here" description="Find customers to prepare your first company." action={<s-button href="/migration">Find customers</s-button>} />Properties
| Property | Type | Default | Description |
|---|---|---|---|
| title | string | Required | Describe what will appear. |
| description | string | Required | Explain the next step or why a search is empty. |
| action | ReactNode | — | Native primary action. |
| kind | string | companies | companies or tasks artwork. |
Design and interaction
Use after a successful empty read. Show loading and errors separately. Do not imply a failed request means zero records.
Accessibility
Decorative SVG is hidden from assistive technology; the section has an accessible title.
Implementation and ownership
Source: Kaupvik Website, packages/polaris. React client component; controlled host data. No API credentials or merchant transport are included. Host applications own authentication, validation, localization, errors and persisted preferences. Graph nodes use native Shopify identities; diagram positions are presentation only.
Tokens and states
Native controls use Shopify attributes and inherit the host’s design system. Kaupvik layout tokens: --kp-surface, --kp-surface-subdued, --kp-ink, --kp-ink-subdued, --kp-border, --kp-accent, --kp-focus, --kp-radius, --kp-space. Override only within the product surface. Loading, error and empty states are distinct; host data is never invented to fill a preview.
Verification
Test keyboard and pointer operation, focus visibility, 375px and desktop layouts, reduced motion and server hydration. Test every product adapter independently before release. QO remains on its reviewed implementation until its own adoption release.
Related product patterns