# Sparkle Burst

A ring of four-point star sparkles that pops out from a point, spins and fades, over a soft pulse ring.

```bash
npx shadcn add https://www.reelcn.dev/r/sparkle-burst.json
```

Usage:

```tsx
<Sequence from={20} durationInFrames={40}>
  <SparkleBurst origin={{ x: 72, y: 64 }} count={8} />
</Sequence>
```

Use for:

- Drawing the eye to a button, price or word the moment it appears
- A small "done" or "new" accent on a card

Avoid:

- Full-screen celebrations. Use `confetti`

Dependencies:

- `remotion`


## Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| delay? | `number` | — | Frames to wait before entering. |
| duration? | `number` | — | Enter duration in frames. Defaults to 0.6s. Some items reuse `duration` for an unrelated local timing. See that item's own prop docs. |
| exit? | `number \| boolean` | — | Exit at the end of the parent `<Sequence>`. `false` keeps it on screen, a number sets the exit length in frames. |
| motion? | `MotionPersonality` | — | Override the theme's motion personality. |
| poster? | `boolean` | — | Renders fully entered, with no exit: for a still frame or thumbnail. Defaults to `false`. |
| holdFrames? | `number` | — | Delays the start of the exit window by this many frames, for a minimum on-screen hold. Defaults to `0`. |
| origin? | `{ x: number; y: number; }` | `{ x: 50, y: 50 }` | Center of the burst in % of the canvas (0-100 on each axis). |
| count? | `number` | `8` | Number of sparkles. 6-12 reads best. |
| radius? | `number` | `150` | How far the sparkles travel, in design units. |
| size? | `number` | `44` | Largest sparkle size in design units. |
| color? | `string` | — | Sparkle color. Defaults to the theme highlight. |
| secondaryColor? | `string` | — | Every other sparkle, and the pulse ring. Defaults to the theme accent. |
| ring? | `boolean` | `true` | Show the expanding ring behind the sparkles. |
| seed? | `string \| number` | `"sparkle"` |  |
| style? | `CSSProperties` | — |  |
| className? | `string` | — |  |