# Data Story

Report video that walks through numbers: a title, then one bar, line, donut or stat scene per section with its caption.

```bash
npx shadcn add https://www.reelcn.dev/r/data-story.json
```

Usage:

```tsx
<Composition
  id="DataStory"
  component={DataStory}
  schema={dataStorySchema}
  defaultProps={dataStoryDefaults}
  calculateMetadata={dataStoryMetadata}
  width={1920}
  height={1080}
  fps={30}
  durationInFrames={1}
/>
```

Use for:

- Quarterly results, year-in-review and research findings
- Turning a dashboard into a narrated walkthrough

Avoid:

- A single number. Use `stat-counter`

Dependencies:

- `zod`


## Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| title | `string` | — |  |
| sections | `{ kind: "line" \| "bar" \| "donut" \| "stat"; data: { label: string; value: number; }[]; caption: string; }[]` | — |  |
| theme? | `"daylight" \| "midnight" \| "mono" \| "ledger" \| "afterglow" \| "chromewave" \| "neon" \| "paper" \| "sunset"` | — | Theme preset. Inherits the surrounding `ThemeProvider` when omitted. |
| brand? | `{ accent?: string; logo?: string; font?: string; }` | — |  |
| sfx? | `boolean` | — | Plays a soft whoosh as each scene starts. |
| music? | `string` | — | Background music file, looped under everything at 25% volume. |