# Card Fan

> Cards fan out on an arc and turn one step at a time, lifting the centre card into focus.

- Collection: Illustrations
- Tier: pro
- Docs: https://geturui.com/docs/card-fan
- Install: `npx shadcn@latest add @geturui-pro/card-fan`
- Dependencies: motion

## Variants

### Payments

Gradient payment cards turn on an arc while the charge for the centre card pops in above it.

Install: `npx shadcn@latest add @geturui-pro/card-fan-payments`

```tsx
import { CardFanPayments } from "@/components/illustrations/card-fan/payments";

export function PaymentsIllustration() {
  return (
    <div className="rounded-xl border border-border bg-surface p-4">
      <CardFanPayments className="w-full" />
    </div>
  );
}
```

| Prop | Type | Default | Description |
|---|---|---|---|
| speed | `number` | 1 | Speed multiplier for the loop (2.2 seconds per step at 1). |
| title | `string` | — | Accessible description of the scene, used as the aria-label. |
| className | `string` | — | Classes for the SVG; it fills its container width and keeps its ratio. |

### Documents

Documents turn on an arc; each centre page is signed and verified as it passes.

Install: `npx shadcn@latest add @geturui-pro/card-fan-documents`

```tsx
import { CardFanDocuments } from "@/components/illustrations/card-fan/documents";

export function DocumentsIllustration() {
  return (
    <div className="rounded-xl border border-border bg-surface p-4">
      <CardFanDocuments className="w-full" />
    </div>
  );
}
```

| Prop | Type | Default | Description |
|---|---|---|---|
| speed | `number` | 1 | Speed multiplier for the loop (2.4 seconds per step at 1). |
| title | `string` | — | Accessible description of the scene, used as the aria-label. |
| className | `string` | — | Classes for the SVG; it fills its container width and keeps its ratio. |

## Accessibility

- Rendered as a single SVG with role="img" and an aria-label you can override with `title`; nothing inside is focusable.
- Under prefers-reduced-motion the scene renders one meaningful still frame: no loops, no timers.
- Colours come from the GetUrUI tokens only, so the scene follows light and dark themes automatically.

## Source

Pro item — send `Authorization: Bearer <registry token>` to include the source.
