# Cradle Text
> A headline hung like a Newton's cradle, so a knock on one letter clacks through the word, built with React and pendulum physics.

## Installation

```bash
npx shadcn@latest add @kokonutui/cradle-text
```

## Props

| Prop           | Type       | Default     | Description                                                                                      |
|----------------|------------|-------------|--------------------------------------------------------------------------------------------------|
| `text?`       | `string`   | `"Momentum"`  | The line of letters hung from the rail. Keep it to one line.                                   |
| `className?`  | `string`   |             | Extra classes for the root element.                                                              |
| `intro?`      | `boolean`  | `true`     | Lift the first letter and let it go once, the first time it's seen.                             |
| `bounce?`     | `number`   | `0.97`     | How much speed a collision keeps, 0 to 1. Steel is about 0.95.                                  |

## Source

```tsx
"use client";

/**
 * @author: @dorianbaffier
 * @description: Cradle Text
 * @version: 1.0.0
 * @date: 2026-10-15
 * @license: MIT
 * @website: https://kokonutui.com
 * @github: https://github.com/kokonut-labs/kokonutui
 */

import { useEffect, useRef } from "react";
import { cn } from "@/lib/utils";

export interface CradleTextProps {
  /** The line of letters hung from the rail. Keep it to one line. */
  text?: string;
  className?: string;
  /** Lift the first letter and let it go once, the first time it's seen. */
  intro?: boolean;
  /** How much speed a collision keeps, 0 to 1. Steel is about 0.95. */
  bounce?: number;
}

// ... (rest of the code is omitted for brevity)

export default function CradleText({
  text = "Momentum",
  className,
  intro = true,
  bounce = 0.97,
}: CradleTextProps) {
  // ... (rest of the component implementation)
}
```
