# Top Down Letters

Each letter falls from above with a staggered fade-in cascade.

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown variants are available by appending `.md` to any URL or sending an `Accept: text/markdown` header. An agent skill is available at [/.well-known/agent-skills/site-skill.md](/.well-known/agent-skills/site-skill.md).

## Installation

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

```bash
npx shadcn@latest add @framecn/top-down-letters
```

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

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

## Usage

```tsx
import { TopDownLetters } from "@/components/framecn/top-down-letters";
```

```tsx
<TopDownLetters text="Hello world" />
```

## API Reference

### TopDownLetters

| Prop               | Type     | Default         |
| ------------------ | -------- | --------------- |
| `text`             | `string` | `"Hello world"` |
| `staggerDelay`     | `number` | `3`             |
| `distance`         | `number` | `46`            |
| `fontSize`         | `number` | `72`            |
| `color`            | `string` | `"#171717"`     |
| `fontWeight`       | `number` | `600`           |
| `speed`            | `number` | `1`             |
| `fps`              | `number` | `30`            |
| `durationInFrames` | `number` | `90`            |
| `className`        | `string` | `-`             |

## Notes

  Text is split into individual characters. Spaces are preserved using
  `white-space: pre`. The `distance` prop controls how far above each letter
  starts before falling into place.