# Text Loop

> Loops through any content, not only words.

Logos, badges, quotes or icons with labels take turns with a slide, fade, blur or scale. Hover pauses it.

- Family: Typography
- Plan: Creative. Included with Creative.
- Requires: React, Tailwind CSS v4 and the motion package
- Page with a live preview: https://galactrex.com/ui/text-loop/
- Licence: https://galactrex.com/ui/license/

## Install

```sh
npx @galactrex/ui login   # once, with an API key from https://galactrex.com/account/
npx @galactrex/ui add text-loop
```

It installs to `components/galactrex/text-loop.tsx`, with the shared motion helpers beside it. First time in a project: `npx @galactrex/ui init` (setup guide: https://galactrex.com/docs/ui-components-setup/).

## Usage

```tsx
import { TextLoop } from "@/components/galactrex/text-loop";

<TextLoop><span>Fast</span><span>Private</span><span>Yours</span></TextLoop>
```

## Props

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `children` | `ReactNode` | — | Each child takes a turn. |
| `every` | `number` | `2.4` | Seconds per item. |
| `transition` | `"slide" \| "fade" \| "blur" \| "scale"` | `"slide"` | Hand-over. |
| `pauseOnHover` | `boolean` | `true` | Stop while hovered. |
| `className` | `string` | — | Extra classes for the outer element. |

## Variants

- **Badges.** Rotating status chips.

## Accessibility

- Not a live region: changes are not announced; put essential content elsewhere too.

## Motion

- Presence transitions; pauses offscreen.
- Reduced motion: fades.