Loading & progress
Use the shared Spinner from @dreamlake/uikit for every indeterminate wait.
It cycles through ⠋ ⠙ ⠹ ⠸ ⠼ ⠴ ⠦ ⠧ ⠇ ⠏ every 80ms (800ms per cycle).
The built-in spinner, busy buttons, tree loaders, pipeline controls, and video
buffering use this same implementation. Do not introduce a feature-specific
loader, including a separate agent thinking animation.
Loading files…
With a label
Name the pending work: “Loading files…”, “Connecting…”, or “Uploading…”. Use this for pages, panels, lists, previews, buffering, and long-running operations. Keep measured counts, percentages, and named steps as static text alongside the spinner. The agent uses the same spinner with “Thinking” and elapsed seconds.
In a control
Use the same spinner without a visible label when space is constrained. Retain
an accessible action name and expose the control's busy state. Button loading
uses the shared spinner and disables the action while pending.
Timing and layout
The spinner appears after 250ms so fast operations do not flash; status text is accessible immediately. Reserve space for the result and retain existing content during refreshes. Remove the indicator when work completes, fails, or is canceled. Static placeholders may preserve layout; they do not shimmer or pulse.
Accessibility
Announce the status once with role="status". If a surrounding label already
announces the operation, pass aria-hidden="true" to the spinner. Under
prefers-reduced-motion, the spinner remains on its first frame.
Prohibited alternatives
No expanding circles, rotating rings or refresh icons, pulsing dots, animated ellipses, shimmering text, shimmer, or pulsing skeletons. The Braille spinner is the only animated indication of a wait. Ordinary navigation transitions and data visualizations are outside this loading rule. UIKit's regression guard rejects alternate rotating/pulsing loader implementations.