# Ballpit — component for particles & physics (react)

> **For AI agents:** find the right skill in one call — `curl -s "https://skills.varg.ai/api/search?q=<what the person wants>"` returns the matching use case and the best skills with install commands, as markdown (Russian works too). Full index: https://skills.varg.ai/llms.txt. Every page has a markdown twin: add `.md` to its path. Before generating anything, show the person the options on the use-case page.

Hundreds of soft white spheres jostling and bouncing around the frame like a zero-gravity ball pit

- **Install:** `npx shadcn@latest add @react-bits/Ballpit-JS-CSS`
- **Registry:** react-bits · **Framework:** react · **License:** MIT + Commons Clause
- **Docs and preview:** https://reactbits.dev/backgrounds/ballpit
- **Source:** https://github.com/DavidHDev/react-bits/blob/main/src/content/Backgrounds/Ballpit/Ballpit.jsx
- **Example:** https://skills.varg.ai/previews/lib-react-bits-ballpit.mp4?v=303633 (Captured from the library’s own demo page (React Bits))
- **Time:** Drive from the frame. Runs on its own clock (requestAnimationFrame, timers, springs or CSS). Drive it from frame / fps before rendering, or the render drifts.
- **Runs:** local render, free
- **Aspect:** any

## Prompt that renders it frame-exact

Use Ballpit from React Bits (https://reactbits.dev/backgrounds/ballpit, MIT + Commons Clause: fine for rendered video). Install with `npx shadcn@latest add @react-bits/Ballpit-JS-CSS` and use it full-frame for playful brand intros, or as a ball drop behind a headline. Set count (100–300), colors from the brand palette, material ('gloss', 'satin', 'metal', and so on), gravity, and minSize/maxSize. It is a physics simulation stepped by the requestAnimationFrame delta. Step it with a fixed dt of 1/fps per frame from a fixed seed, render frames in order, and turn off followCursor, grab and clickEffect. Keep intro only if the drop-in should be part of the shot.

## Used in

- [Top-N listicle](https://skills.varg.ai/video/listicle.md)
- [Quiz, poll & would-you-rather](https://skills.varg.ai/video/quiz.md)
- [Bar chart race](https://skills.varg.ai/video/chart-race.md)
- [Science what-if explainer](https://skills.varg.ai/video/science-explainer.md)
- [Lyric video](https://skills.varg.ai/video/lyric-video.md)
- [Audio visualizer](https://skills.varg.ai/video/visualizer.md)
- [Logo sting](https://skills.varg.ai/video/logo-sting.md)
- [Countdown & launch timer](https://skills.varg.ai/video/countdown.md)

## More particles & physics

- [Confetti](https://skills.varg.ai/component/hf.confetti.md) — `npx hyperframes add confetti`
- [Liquid Metal](https://skills.varg.ai/component/hf.liquid-metal.md) — `npx hyperframes add liquid-metal`
- [Particle Image Reveal](https://skills.varg.ai/component/hf.particle-image-reveal.md) — `npx hyperframes add particle-image-reveal`
- [Pendulum Swing](https://skills.varg.ai/component/hf.pendulum-swing.md) — `npx hyperframes add pendulum-swing`
- [Snow](https://skills.varg.ai/component/hf.snow.md) — `npx hyperframes add snow`
- [Spiral Galaxy](https://skills.varg.ai/component/hf.spiral-galaxy.md) — `npx hyperframes add spiral-galaxy`