Foundations · stable · MIT

Spinner

A compact named loading indicator with reduced-motion state.

Install editable source

Add Spinner

Base UI / canonicalnpx shadcn@latest add https://gummyui.dev/r/gummy-spinner.json

No package dependency beyond React. Shared Gummy material is resolved automatically.

Behavior contract

Semantics before surface

Semantics

Status semantics are opt-in through the visible or accessible label.

Keyboard

No component-specific keys.

System support

Light and dark themes, logical RTL layout, reduced motion, responsive content, and forwarded public refs.

Source-derived reference

Anatomy and public API

Exported anatomy

These public React parts are read directly from the canonical source during the documentation build.

  • GummySpinner

Prop contracts

GummySpinnerProps

Composes React.HTMLAttributes<HTMLSpanElement> & { label?: string; size?: "small" | "medium" | "large"; tone?: "raspberry" | "grape" | "aqua" | "current"; }

Troubleshooting

Check behavior before surface.

Live product source

Inspect the canonical states

The Component Lab exercises real source across default, focus, disabled, responsive, dark, reduced-motion, and RTL contexts.

Open the live Component Lab

Interactive inspection

Try Spinner in context

Resize the canvas, switch its theme, or reverse its reading direction without changing the rest of the page.

Width
Theme
Direction
Publishing release…

Spinner preview: fluid width, light theme, left to right.

Editable source

Read before you install

Canonical Base UI or native source

Loading editable source…