---
title: Spinner
description: An indicator that can be used to show a loading state.
base: base
component: true
---

```tsx
import { Item, ItemContent, ItemMedia, ItemTitle } from '@/components/ui/item'
import { Spinner } from '@/components/ui/spinner'

export function SpinnerDemo() {
  return (
    <div className="flex w-full max-w-xs flex-col gap-4 [--radius:1rem]">
      <Item variant="muted">
        <ItemMedia>
          <Spinner stroke={1.75} />
        </ItemMedia>
        <ItemContent>
          <ItemTitle className="line-clamp-1">Processing payment...</ItemTitle>
        </ItemContent>
        <ItemContent className="flex-none justify-end">
          <span className="text-sm tabular-nums">$100.00</span>
        </ItemContent>
      </Item>
    </div>
  )
}
```

## Installation

<CodeTabs>

<TabsList>
  <TabsTrigger value="cli">Command</TabsTrigger>
  <TabsTrigger value="manual">Manual</TabsTrigger>
</TabsList>
<TabsContent value="cli">

```bash
moi ui-components add spinner
```

</TabsContent>

<TabsContent value="manual">

<Steps className="mb-0 pt-2">

<Step>Copy and paste the following code into your project.</Step>

<ComponentSource
  name="spinner"
  title="components/ui/spinner.tsx"
  styleName="base-nova"
/>

<Step>Update the import paths to match your project setup.</Step>

</Steps>

</TabsContent>

</CodeTabs>

## Usage

```tsx
import { Spinner } from '@/components/ui/spinner'
```

```tsx
<Spinner stroke={1.75} />
```

## Customization

You can replace the default spinner icon with any other icon by editing the `Spinner` component.

```tsx
import { cn } from 'cn'
import { IconLoader2 } from '@tabler/icons-react'

type SpinnerProps = React.ComponentProps<typeof IconLoader2>

function Spinner({ className, ...props }: SpinnerProps) {
  return (
    <IconLoader2
      stroke={1.75}
      role="status"
      aria-label="Loading"
      className={cn('size-4 animate-spin', className)}
      {...props}
    />
  )
}

export function SpinnerCustom() {
  return (
    <div className="flex items-center gap-4">
      <Spinner stroke={1.75} />
    </div>
  )
}
```

```tsx showLineNumbers title="components/ui/spinner.tsx"
import { cn } from 'cn'
import { IconLoader2 } from '@tabler/icons-react'

type SpinnerProps = React.ComponentProps<typeof IconLoader2>

function Spinner({ className, ...props }: SpinnerProps) {
  return (
    <IconLoader2
      stroke={1.75}
      role="status"
      aria-label="Loading"
      className={cn('size-4 animate-spin', className)}
      {...props}
    />
  )
}

export { Spinner }
```

## Size

Use the `size-*` utility class to change the size of the spinner.

```tsx
import { Spinner } from '@/components/ui/spinner'

export function SpinnerSize() {
  return (
    <div className="flex items-center gap-6">
      <Spinner stroke={1.75} className="size-3" />
      <Spinner stroke={1.75} className="size-4" />
      <Spinner stroke={1.5} className="size-6" />
      <Spinner stroke={1.5} className="size-8" />
    </div>
  )
}
```

## Button

Add a spinner to a button to indicate a loading state. Place the `<Spinner />` before the label with `data-icon="inline-start"` for a start position, or after the label with `data-icon="inline-end"` for an end position.

```tsx
import { Button } from '@/components/ui/button'
import { Spinner } from '@/components/ui/spinner'

export function SpinnerButton() {
  return (
    <div className="flex flex-col items-center gap-4">
      <Button disabled size="sm">
        <Spinner stroke={1.75} data-icon="inline-start" />
        Loading...
      </Button>
      <Button variant="outline" disabled size="sm">
        <Spinner stroke={1.75} data-icon="inline-start" />
        Please wait
      </Button>
      <Button variant="secondary" disabled size="sm">
        <Spinner stroke={1.75} data-icon="inline-start" />
        Processing
      </Button>
    </div>
  )
}
```

## Badge

Add a spinner to a badge to indicate a loading state. Place the `<Spinner />` before the label with `data-icon="inline-start"` for a start position, or after the label with `data-icon="inline-end"` for an end position.

```tsx
import { Badge } from '@/components/ui/badge'
import { Spinner } from '@/components/ui/spinner'

export function SpinnerBadge() {
  return (
    <div className="flex items-center gap-4 [--radius:1.2rem]">
      <Badge>
        <Spinner stroke={1.75} data-icon="inline-start" />
        Syncing
      </Badge>
      <Badge variant="secondary">
        <Spinner stroke={1.75} data-icon="inline-start" />
        Updating
      </Badge>
      <Badge variant="outline">
        <Spinner stroke={1.75} data-icon="inline-start" />
        Processing
      </Badge>
    </div>
  )
}
```

## Input Group

```tsx
import { IconArrowUp } from '@tabler/icons-react'

import {
  InputGroup,
  InputGroupAddon,
  InputGroupButton,
  InputGroupInput,
  InputGroupTextarea
} from '@/components/ui/input-group'
import { Spinner } from '@/components/ui/spinner'

export function SpinnerInputGroup() {
  return (
    <div className="flex w-full max-w-md flex-col gap-4">
      <InputGroup>
        <InputGroupInput placeholder="Send a message..." disabled />
        <InputGroupAddon align="inline-end">
          <Spinner stroke={1.75} />
        </InputGroupAddon>
      </InputGroup>
      <InputGroup>
        <InputGroupTextarea placeholder="Send a message..." disabled />
        <InputGroupAddon align="block-end">
          <Spinner stroke={1.75} /> Validating...
          <InputGroupButton className="ml-auto" variant="default">
            <IconArrowUp stroke={1.75} />
            <span className="sr-only">Send</span>
          </InputGroupButton>
        </InputGroupAddon>
      </InputGroup>
    </div>
  )
}
```

## Empty

```tsx
import { Button } from '@/components/ui/button'
import {
  Empty,
  EmptyContent,
  EmptyDescription,
  EmptyHeader,
  EmptyMedia,
  EmptyTitle
} from '@/components/ui/empty'
import { Spinner } from '@/components/ui/spinner'

export function SpinnerEmpty() {
  return (
    <Empty className="w-full">
      <EmptyHeader>
        <EmptyMedia variant="icon">
          <Spinner stroke={1.5} />
        </EmptyMedia>
        <EmptyTitle>Processing your request</EmptyTitle>
        <EmptyDescription>
          Please wait while we process your request. Do not refresh the page.
        </EmptyDescription>
      </EmptyHeader>
      <EmptyContent>
        <Button variant="outline" size="sm">
          Cancel
        </Button>
      </EmptyContent>
    </Empty>
  )
}
```

## RTL

```tsx
'use client'

import * as React from 'react'

import { useTranslation, type Translations } from '@/components/language-selector'
import { Item, ItemContent, ItemMedia, ItemTitle } from '@/components/ui/item'
import { Spinner } from '@/components/ui/spinner'

const translations: Translations = {
  en: {
    dir: 'ltr',
    values: {
      title: 'Processing payment...',
      amount: '$100.00'
    }
  },
  ar: {
    dir: 'rtl',
    values: {
      title: 'جاري معالجة الدفع...',
      amount: '١٠٠.٠٠ دولار'
    }
  },
  he: {
    dir: 'rtl',
    values: {
      title: 'מעבד תשלום...',
      amount: '$100.00'
    }
  }
}

export function SpinnerRtl() {
  const { dir, t } = useTranslation(translations, 'ar')

  return (
    <div className="flex w-full max-w-xs flex-col gap-4 [--radius:1rem]" dir={dir}>
      <Item variant="muted" dir={dir}>
        <ItemMedia>
          <Spinner stroke={1.75} />
        </ItemMedia>
        <ItemContent>
          <ItemTitle className="line-clamp-1">{t.title}</ItemTitle>
        </ItemContent>
        <ItemContent className="flex-none justify-end">
          <span className="text-sm tabular-nums">{t.amount}</span>
        </ItemContent>
      </Item>
    </div>
  )
}
```
