Refined UI

An opinionated, customizable superset of shadcn/ui

AgentsPrimitivesSkillsSkins
Guides
  • Overview
  • Get started
  • Shadcn compatibility
  • Architecture
  • Agent surface
Primitives
  • Accordion
  • Alert
  • Alert dialog
  • Aspect ratio
  • Autocomplete
  • Avatar
  • Badge
  • Button
  • Button group
  • Calendar
  • Card
  • Checkbox
  • Checkbox Group
  • Code
  • Code Diff
  • Collapsible
  • Color Picker
  • Combobox
  • Command
  • Date Picker
  • Dialog
  • Drawer
  • Empty
  • Field
  • Form
  • Gradient Editor
  • Hover card
  • Input
  • Input group
  • Input OTP
  • Item
  • Kbd
  • Markdown
  • Menu
  • Menubar
  • Meter
  • Native select
  • Navigation menu
  • Number Field
  • Pagination
  • Popover
  • Progress
  • Radio group
  • Resizable
  • Scroll area
  • Select
  • Sidebar
  • Skeleton
  • Slider
  • Spinner
  • Switch
  • Table
  • Table of contents
  • Tabs
  • Textarea
  • Toast
  • Toggle
  • Toolbar
  • Tooltip
  • Tree
  • Trigger Menu
  • Typography
Hooks
  • Use Chat Message
  • Use Chat Input
  • Use User Ask
  • Use Audio Recorder
  • Use Environment Variables
  • Use Copy To Clipboard
  • Use Tool Call
  • Use Sidebar Resize
Utils
  • cn
  • Skin
  • Contracts
  • Serialize
Extensions
  • Control Effects
  • View Transition
  • Send Aurora
  1. Primitives
  2. Spinner
Primitives

Spinner

Accessible loading indicator for pending buttons, panels, and inline waits.

Composition

The preferred shape for composing the installed primitive from its exported parts.

Root

Single-slot surface with no nested parts.

Spinner

The refined source installs this primitive from src/registry/sources/refined/ui/spinner.tsx. Install it on its own with the command above, or inspect the source below.

Registry command
npx shadcn@latest add http://127.0.0.1:3000/r/refined/spinner.json
See registry manifest

Raw code

Primary installed primitive source

Spinner slot
src/registry/sources/refined/ui/spinner.tsx
import { Loader2 } from "lucide-react";
import type { SpinnerProps } from "@/components/refined-ui/contracts";
import { cn } from "@/components/refined-ui/lib/cn";
import { skinSlot } from "@/components/refined-ui/skin";
​
// Loader, not expressive motion: NOT gated by motion kill-switch (--duration-*) — spins even under reduced motion.
// role="status" + visually-hidden "Loading" give it accessible name; size walks control ramp (xs..lg).
const spinnerSize = {
xs: "size-3",
sm: "size-4",
md: "size-5",
lg: "size-6",
} as const;
​
export function Spinner({ size = "sm", className, ...props }: SpinnerProps) {
return (
<span
role="status"
data-ui="agent"
data-slot="spinner"
className={cn("inline-flex text-muted-foreground", skinSlot("spinner", {}), className)}
{...props}
>
<Loader2 aria-hidden="true" className={cn("animate-spin", spinnerSize[size])} />
<span className="sr-only">Loading</span>
</span>
);
}
​

On this page

  • Preview
  • Composition
  • Installation
  • Source
LoadingLoadingLoadingLoading