# Staggered Bento Grid

Bento grid where cards cascade in with per-cell sequences.

> 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/staggered-bento-grid
```

<Step>Copy and paste the following code into your project.</Step>

<Step>Update the import paths to match your project setup.</Step>

## Usage

```tsx
import { StaggeredBentoGrid } from "@/components/framecn/staggered-bento-grid";
```

```tsx
<StaggeredBentoGrid />
```

## API Reference

### StaggeredBentoGrid

| Prop               | Type          | Default         |
| ------------------ | ------------- | --------------- |
| `items`            | `BentoItem[]` | `DEFAULT_ITEMS` |
| `staggerDelay`     | `number`      | `8`             |
| `columns`          | `number`      | `3`             |
| `background`       | `string`      | `"#0a0a0a"`     |
| `cardColor`        | `string`      | `"#1a1a1a"`     |
| `textColor`        | `string`      | `"white"`       |
| `speed`            | `number`      | `1`             |
| `fps`              | `number`      | `30`            |
| `durationInFrames` | `number`      | `90`            |
| `className`        | `string`      | `-`             |

## Notes

  Cards cascade in with staggered timing. Each cell has its own animation
  sequence for a dynamic entrance effect.