# tsParticles — card for AI agents

Particle, confetti and fireworks backgrounds for websites with many presets and React/Vue/Angular/Svelte wrappers.

Category: Video references and motion backgrounds (also: Web animation examples and effects) · maker Matteo Bruni · checked 2026-11-10 · style: playful, abstract, dark

## Price
- Price: Free
- Free tier: Fully free.

## License
MIT — https://raw.githubusercontent.com/tsparticles/tsparticles/main/LICENSE

- commercial: **yes** (Commercial use OK)
  > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  (https://raw.githubusercontent.com/tsparticles/tsparticles/main/LICENSE)
- attribution: **no** (No credit needed)
  > The above copyright notice and this permission notice shall be included in all
  (https://raw.githubusercontent.com/tsparticles/tsparticles/main/LICENSE)
- in app: **yes** (Can ship inside your app)
  > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  (https://raw.githubusercontent.com/tsparticles/tsparticles/main/LICENSE)
- redistribute: **yes** (Can pass the files on to your own users)
  > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  (https://raw.githubusercontent.com/tsparticles/tsparticles/main/LICENSE)

## Rules to follow
- Keep the MIT notice if you redistribute the code.
- Respect prefers-reduced-motion.

## Can an AI agent use it by itself?
**Yes** · package: Agent installs a package or loads it from a CDN

## How an agent gets files
- npm install @tsparticles/engine plus a preset or bundle (e.g. tsparticles), then load a JSON options object. (sign-in: none)
- Formats: js, json

## How to connect
- Package (npm/PyPI)
- npm: `npm install tsparticles`
- Repository: https://github.com/tsparticles/tsparticles
- Website: https://particles.js.org

## Numbers (AgentGid data)
- Gid Score: 36
- GitHub stars: 9,101
- Downloads last week: 134,428
- Used in 1 public projects set up for AI coding agents

## Lines to paste into your prompt or AGENTS.md

```
- tsParticles (Video references and motion backgrounds, Web animation examples and effects). Particle, confetti and fireworks backgrounds for websites with many presets and React/Vue/Angular/Svelte wrappers. Price: free; commercial use OK; no credit needed. Style: playful, abstract, dark.
  Connect: npm tsparticles.
  Get files: npm install @tsparticles/engine plus a preset or bundle (e.g. tsparticles), then load a JSON options object (js, json).
  Rule: Keep the MIT notice if you redistribute the code.
  Rule: Respect prefers-reduced-motion.
  License: https://raw.githubusercontent.com/tsparticles/tsparticles/main/LICENSE (checked 2026-11-10; details: https://agentgid.com/assets/tsparticles/)
```

## Links
- AgentGid page: https://agentgid.com/assets/tsparticles/
- Is it free for commercial use? https://agentgid.com/assets/tsparticles/commercial-use/
- Source: https://particles.js.org/
- Source: https://raw.githubusercontent.com/tsparticles/tsparticles/main/LICENSE
- Source: https://registry.npmjs.org/tsparticles/latest


## tsParticles: moving particle backgrounds and confetti for sites

tsParticles is a free code library that fills part of a web page with moving dots, stars or shapes, often joined by thin lines. It can also fire confetti or fireworks on cue. You describe the look in a short settings block, and it draws the animation in the visitor's browser. It works with React, Vue, Angular, Svelte and plain pages, and the MIT license allows paid use.

### Where to use it
- Moving background behind a page header: Put softly moving, connected dots behind the headline of a landing page or sign-up screen, in your brand colors.
- Confetti when something succeeds: Fire a burst of confetti when a user finishes sign-up, places an order or reaches a goal, with one line of code.
- Particles in a React app: Add the same background as a component in a React or Next.js app, with the effect loaded once for the whole app.
- Calmer pages for motion-sensitive visitors: Slow down or stop the animation for visitors who asked their device for less motion, so the page stays comfortable.
- Replace an old particles.js setup: Move an older site that used the particles.js library to the maintained tsParticles, keeping its settings.
- Festive seasonal banner: Add falling snow, stars or fireworks to a holiday sale banner for a few weeks, then switch it off. (idea, not from the official pages)

### How to start
- Install the engine plus one bundle; the slim bundle is the usual choice.

```
pnpm add @tsparticles/engine @tsparticles/slim
```

- Load the bundle into the engine first, then start the animation in an element with an id.

```
import { tsParticles } from "@tsparticles/engine";
import { loadSlim } from "@tsparticles/slim";
await loadSlim(tsParticles);
await tsParticles.load({ id: "tsparticles", options: { particles: { links: { enable: true }, move: { enable: true } } } });
```

- For confetti alone, the confetti package has its own one-call function and needs no engine setup.

```
pnpm add @tsparticles/confetti
```


### License
MIT license, so it is free in personal and paid projects and you may share and change the code. Keep the copyright and license notice when you ship copies of the code.

### Good to know
- The core engine alone draws nothing. You always add a bundle, such as slim, or single add-ons, and load it before starting.
- It needs the browser, so in Next.js, Nuxt or Astro it must load only on the visitor's side, not on the server.
- Many particles slow down weaker phones and laptops. Start with about 50 and raise the number carefully.
- Keep all tsParticles packages on the same version, or you may get errors.

Checked 2026-11-10 against: https://particles.js.org/, https://particles.js.org/llms.txt, https://particles.js.org/guide/getting-started, https://particles.js.org/guide/installation, https://particles.js.org/guide/bundles-confetti, https://particles.js.org/guide/wrappers, https://particles.js.org/guide/wrappers-react, https://particles.js.org/guide/troubleshooting, https://particles.js.org/guide/mcp-server, https://github.com/tsparticles/tsparticles/blob/main/README.md, https://github.com/tsparticles/tsparticles/blob/main/LICENSE, https://github.com/tsparticles/tsparticles/blob/main/wrappers/react/README.md, https://github.com/tsparticles/tsparticles/blob/main/markdown/Options.md, https://github.com/tsparticles/tsparticles/blob/main/markdown/Options/Motion.md, https://github.com/tsparticles/tsparticles/blob/main/markdown/Options/FullScreen.md, https://github.com/tsparticles/tsparticles/blob/main/markdown/Options/Plugins/Motion.md, https://github.com/tsparticles/tsparticles/blob/main/plugins/motion/README.md, https://github.com/tsparticles/tsparticles/blob/main/markdown/Options/Particles.md, https://github.com/tsparticles/tsparticles/blob/main/markdown/Options/Particles/Paint.md, https://registry.npmjs.org/tsparticles/latest, https://registry.npmjs.org/tsparticles/4.5.3, https://registry.npmjs.org/@tsparticles/engine/latest, https://registry.npmjs.org/@tsparticles/slim/latest, https://registry.npmjs.org/@tsparticles/confetti/4.5.3, https://registry.npmjs.org/@tsparticles/react/latest

### Mistakes to avoid
- Don't: particles: { color: { value: ["#3b5bdb", "#12b886"] } } in version 4 to color the dots → Do: particles: { paint: { fill: { enable: true, color: { value: ["#3b5bdb", "#12b886"] } } } } (In our 4.5.3 demo the color option left the dots white (the paint default) while paint.fill colored them.)
- Don't: Installing only @tsparticles/engine and calling tsParticles.load() → Do: Install a bundle too and await loadSlim(tsParticles) (or loadBasic, loadFull, loadAll) before load() (The engine has no shapes or movement of its own, so the canvas stays blank.)
- Don't: Leaving fullScreen at its default when the effect should sit inside one section → Do: Set fullScreen: { enable: false } and size the container element with CSS (fullScreen is on by default, so the canvas covers the whole window instead of the header box.)
- Don't: Mounting ParticlesProvider inside a page or a component that can unmount → Do: Put ParticlesProvider once at the app root (main.tsx or layout.tsx) (Re-mounting it throws an error or is silently ignored.)
- Don't: Adding motion: { disable: true } to a slim or full bundle setup and expecting it to work → Do: Install @tsparticles/plugin-motion and await loadMotionPlugin(tsParticles) before load(); the confetti bundle already includes it (The motion option belongs to a separate plugin; the tsparticles 4.5.3 full bundle file has no reduced-motion check (we searched it), while the confetti bundle does.)

### Questions
- Can I use tsParticles on a client's or a paid site? Yes. The MIT license allows commercial use; keep the license notice with copies of the code.
- Which bundle should I install? Slim for most sites; basic for the smallest setup; the full tsparticles bundle for emitters, text shapes and trails; confetti, fireworks or ribbons when you only need that effect.
- Does the confetti respect visitors who prefer less motion? Yes, the confetti bundle includes the motion add-on, which follows the reduced-motion setting.
- Are there ready-made looks? Yes, a configs package holds dozens of ready settings such as snow, stars and bubbles that you load by name.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
