Search documentation

Search guides, examples, and component APIs.

Quick links
↑↓ NavigateEnter OpenEsc Close
Get started

Blocks / Feedback & states

Loading states

A weekly report whose KPI cards, stacked bar chart, and channel table all have matching skeletons, with a determinate or indeterminate progress panel while it regenerates.

bunx --bun @getweini/cli@latest add alert button card progress skeleton spinner
Customize
  • Match the loading pattern to what you know. Use `Skeleton` for content whose shape is known, `Progress` with a value when you can measure the work, and an indeterminate `Progress` or `Spinner` when you cannot.
  • Pass `rows` with raw numbers (`visits`, `conversion`, and `change` in percent). The KPIs, chart, and table are all derived from them, so the figures always agree; format them through the small helpers at the top.
  • Set `loading` while the request runs and pass `progress` (0 to 100) when you have a percentage. Leave `progress` undefined for the indeterminate state. `generate` and `cancel` are emitted for you to handle.
  • The panel is a polite `role="status"` region and the content is marked `aria-busy`, so assistive technology hears the change once. Skeletons and the spinner are decorative and hidden from screen readers.
  • Skeletons reuse the same cards, grid columns, and row heights as the real content, so the layout does not jump when data arrives. Pass `error` to show a failure with a retry action.