# Matrix Loader (/docs/matrix-loader)

A compact 4×4 dot loader with several delay patterns.

## Install

```bash
npx shadcn@latest add https://4af.selfsimilar.dev/r/matrix-loader.json
```

## Usage

```tsx
import { MatrixLoader } from "@/components/ui/matrix-loader";

<MatrixLoader variant="twinkle" label="Loading" />
```

## API

**Main export:** `MatrixLoader`

A 4×4 grid of dots that pulse in turn. `variant` sets the pattern (`scan` or `twinkle`), `size`
the dot scale, and `duration` the cycle length in seconds.

Pass `label` when the loader itself should announce a busy status. Leave it out when nearby text
already says what is loading.

The loop keeps its duration under reduced motion rather than collapsing into a strobe.