# Gradient Fill

Siri-style gradient sweeps across text via background-clip on each word speaking window.

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown variants are available by appending `.md` to any URL or sending an `Accept: text/markdown` header. An agent skill is available at [/.well-known/agent-skills/site-skill.md](/.well-known/agent-skills/site-skill.md).

## Installation

<TabsTrigger value="cli">Command</TabsTrigger>
<TabsTrigger value="manual">Manual</TabsTrigger>

```bash
npx shadcn@latest add @framecn/caption-gradient-fill
```

  <Step>Copy and paste the following code into your project.</Step>
  <ComponentSource
    name="gradient-fill"
    title="components/ui/caption-gradient-fill.tsx"
  />
  <Step>Update the import paths to match your project setup.</Step>

## Usage

```tsx
import { CaptionGradientFill } from "@/components/framecn/caption-gradient-fill";
```

```tsx
<CaptionGradientFill />
```

## API Reference

### CaptionGradientFill

| Prop               | Type               | Default      |
| ------------------ | ------------------ | ------------ |
| `words`            | `CaptionWord[]`    | (demo words) |
| `fromColor`        | `string`           | `"#fe9f1b"`  |
| `midColor`         | `string`           | `"#ff2063"`  |
| `toColor`          | `string`           | `"#ef7aff"`  |
| `fontSize`         | `number`           | `80`         |
| `fontWeight`       | `number \| string` | `900`        |
| `speed`            | `number`           | `1`          |
| `fps`              | `number`           | `30`         |
| `durationInFrames` | `number`           | `180`        |
| `width`            | `number`           | `1280`       |
| `height`           | `number`           | `720`        |
| `className`        | `string`           | `-`          |

## Notes

  The `start` and `end` fields on each `CaptionWord` are in seconds.