Skip to main content
TermRock
GitHub
ComponentsFeedback

Component · Feedback

Empty State

Useful empty and first-run surfaces: title, explanation, primary/secondary actions, example, shortcut, illustration, context; kinds first-use/no-data/no-results/filtered-out/permission-limited; Full/Inline density; domain recipes.

Kind
widget
Input
interactive
Canvas
120×40

Live preview

Loading terminal preview.

Static terminal poster. Choose Run live to start the Rust demo.

Ghosttyempty-state/basic
Loading terminal poster…
○ loading posterNo input — rendered state only
Empty State · exact mounted Rust story
01 · Purpose
What it is for
Useful empty and first-run surfaces: title, explanation, primary/secondary actions, example, shortcut, illustration, context; kinds first-use/no-data/no-results/filtered-out/permission-limited; Full/Inline density; domain recipes.
Best fit: Feedback · feedback · widget
02 · Behavior
What the mounted story proves
  1. 01
    EmptyState
    Representative 120×40 terminal state.
  2. 02
    Passive paint
    No keyboard or pointer action is claimed by this representative story.
  3. 03
    Evidence stays explicit
    3 covered · 9 partial · 4 missing axes.
03 · Implement
Install, then start from exact code
Install
cargo add termrock --git https://github.com/tailrocks/termrock.git --rev 5283c2acf9154d0cfcd37b1ffe821c00faf90ea2
Add TermRock once. Keep domain effects in the host application.
Minimal implementation
Exact Rust setup used by empty-state/basic.
Open to load code.
04 · Adapt
Variants and composition
Variants
Use the preview Variant menu when alternate registered stories exist. Each selection mounts a fresh configuration.
Composition
Feedback · feedback · widget
05 · Reference
API, tokens, accessibility
API
EmptyStateOpen source ↗
Tokens
DesignSystemInspect exact story code for roles and capability projection.
Accessibility
Input contract mountedNo input claim in the representative story.
Contract
Evidence in progress3/23 axes covered
06 · Go deeper
Advanced guidance
Ownership boundary
TermRock owns reusable terminal rendering and interaction state. The host owns domain data, policy, persistence, authorization, and side effects.
Evidence status
3 covered, 9 partial, and 4 missing contract axes. Missing evidence is not a behavior claim.
Context Meter
ContextMeter is the exact public paint owner for feedback terminal UI.
Error State
Canonical structured recoverable failure surface (see ErrorState). Recovery bundle, detail disclosure, recipes.