Canonical inventory
Feedback · core
Empty state
feedback.empty-stateEmpty state: A system response that communicates progress, status, completion, or a problem.
empty statethe system messagethe progress or status indicator
States5
Touch targetDisplay
Evidence4
Introduced by8 kits
Visual specimen
Same contract. Every kit voice.
Empty stateEmpty state: A system response that communicates progress, status, completion, or a problem.
Translation table
What code calls it.
Web<section>The closest native or standardized web primitive.direct
ARIAstatusNo single ARIA role represents the complete component.pattern
SwiftUIContentUnavailableViewThe nearest named SwiftUI API.direct
AppKitCustom NSView compositionAppKit has no single direct equivalent; use a custom view or controller composition.approximation
Anatomy
Every part, named.
- 1Status container
- 2Signal or progress indicator
- 3Primary message
- 4Optional supporting detail or dismissal
Often confused with
Similar shape. Different contract.
Toast
feedback.toastShares a visual family, but has a different role, state model, or interaction contract.
Bannerfeedback.bannerShares a visual family, but has a different role, state model, or interaction contract.
Inline alertfeedback.inline-alertShares a visual family, but has a different role, state model, or interaction contract.
Prompt · paste into your agent
Ask for the exact thing.
Implement the canonical Empty state component (feedback.empty-state). Empty state: A system response that communicates progress, status, completion, or a problem. Support these states: neutral, success, warning, error, loading. Use semantic design tokens rather than raw visual values. Preserve a minimum appropriatepx touch target where interactive. Provide and verify: implementation, state-matrix, responsive, reduced-motion. Keep the component API stable so every Studio kit can supply its own rendering without changing the behavior contract.Studio contract
What must be proven.
Required states
neutral · success · warning · error · loading
Required evidence
implementation · state-matrix · responsive · reduced-motion
Source union
mavan · jade · lumen · aurora · cabana · purple-rain · spatial · margin