# Particles · Pro

Soft points drifting upward at three depths, each with its own size, alpha and wobble. The field shifts with the pointer, deeper layers less, so it reads as space rather than a flat sheet.

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/particles
```

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

## API — Particles
| Prop | Type | Default | Notes |
| --- | --- | --- | --- |
| `count` | `number` | `80` | Particles alive at once. |
| `speed` | `number` | `1` | Drift speed multiplier. |
| `size` | `number` | `3` | Largest radius in px; the rest scale down with depth. |
| `color` | `string` | `var(--ember)` | Any CSS colour, including var(--token). |
| `parallax` | `number` | `1` | How far the field shifts with the pointer; 0 disables it. |
| `className` | `string` | — |  |

See it live: https://charcoalui.com/docs/components/particles