Thinking Orbs

Core Contract

Use thinking-orbs in React 18+ interfaces that need indeterminate AI activity feedback.
Map the real product lifecycle to one of the six shipped states.
Use only the tuned 20 or 64 pixel size. Do not stretch one preset into another.
Keep theme="auto" unless the surrounding surface has a known fixed theme.
Pair the orb with concise visible status text when the activity matters to the user.
Override aria-label with a task-specific label, or hide the orb from assistive technology when adjacent live text already announces the same state.
Use paused to freeze the current frame. Do not simulate pause with speed={0}.
Treat the orb as indeterminate feedback, never as a progress percentage or completion signal.

The package renders monochrome dots on a transparent 2D canvas. It does not expose custom colors, arbitrary sizes, or determinate progress.

Inspect the project package manager, then install: