# Falling Text · Pro

Words drop under gravity, bounce off the walls and pile up at the bottom, and can be picked up and thrown. The physics is a few lines of its own; no engine.

This is a Charcoal UI Pro component. Its source and examples are available with a Pro seat: https://charcoalui.com/pricing

## With a Pro seat

1. Add the registry to components.json:

```json
{
  "registries": {
    "@charcoal": {
      "url": "https://charcoalui.com/r/{name}.json",
      "headers": {
        "Authorization": "Bearer ${CHARCOAL_LICENSE_KEY}"
      }
    }
  }
}
```

2. Copy your licence key from https://charcoalui.com/dashboard and put it in .env.local as CHARCOAL_LICENSE_KEY, then:

```bash
npx shadcn@latest add @charcoal/falling-text
```

To read Pro source through this MCP server, reconnect it with the header "Authorization: Bearer <licence key>".

## API — Falling Text
| Prop | Type | Default | Notes |
| --- | --- | --- | --- |
| `text` | `string` | — |  |
| `trigger` | `"view" \| "hover" \| "click"` | `"view"` | What makes the words drop. With "click", clicking again puts them back. |
| `gravity` | `number` | `1` |  |
| `highlight` | `string[]` | `[]` | Words to colour ember. |
| `className` | `string` | — | Give the box a height so there is room to fall. |

See it live: https://charcoalui.com/docs/components/falling-text