# Spring Pop In

Elastic scale pop with configurable overshoot.

> 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/spring-pop-in
```

<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 { SpringPopIn } from "@/components/framecn/spring-pop-in";
```

```tsx
<SpringPopIn />
```

## API Reference

### SpringPopIn

| Prop               | Type        | Default |
| ------------------ | ----------- | ------- |
| `children`         | `ReactNode` | `-`     |
| `damping`          | `number`    | `12`    |
| `mass`             | `number`    | `1`     |
| `stiffness`        | `number`    | `100`   |
| `delayInFrames`    | `number`    | `0`     |
| `speed`            | `number`    | `1`     |
| `fps`              | `number`    | `30`    |
| `durationInFrames` | `number`    | `45`    |
| `className`        | `string`    | `-`     |

## Notes

  The animation uses a spring function with configurable overshoot. Tune
  `stiffness`, `damping`, and `mass` to shape how far it overshoots before
  settling.