# Starfield

Seeded field of twinkling stars that drifts sideways with depth parallax or flies slowly toward the viewer.

```bash
npx shadcn add https://www.reelcn.dev/r/starfield.json
```

Usage:

```tsx
<AbsoluteFill>
  <Starfield travel="toward" />
  <Center><TextReveal text="Hello" /></Center>
</AbsoluteFill>
```

Use for:

- Space, AI and "big idea" openers, countdowns and launch intros
- A dark, quiet backdrop with a sense of depth

Avoid:

- Large soft out-of-focus discs. Use `bokeh`

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`. |
| background? | `string` | — | Base fill. Defaults to the theme background. |
| color? | `string` | — | Star color. Defaults to the theme foreground. |
| accentColor? | `string` | — | Color for roughly one star in eight. Defaults to the theme accent. |
| count? | `number` | `180` |  |
| travel? | `"across" \| "toward"` | `"across"` | `across` drifts sideways with parallax, `toward` flies slowly into the field. |
| size? | `number` | `3` | Largest star radius in design units. |
| intensity? | `number` | `1` | Star opacity multiplier, 0–1. |
| twinkle? | `number` | `0.35` | Twinkle depth, 0–1. 0 keeps every star steady. |
| seed? | `string \| number` | `1` | Same seed, same sky. |
| speed? | `number` | `1` | Travel speed multiplier. Twinkle keeps its own pace, so 0 gives a still, twinkling sky. |
| style? | `CSSProperties` | — |  |
| className? | `string` | — |  |