Skip to content
Agents tracked: 502 Releases (7d): 613 Agent status: 4 with issuesSince last limit reset: Claude 7d · Codex 5d For AI agents: Markdown Updated Nov 18, 2026

tsParticles

by Matteo Bruni

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

Video references and motion backgrounds Code libraryOpen sourceplayfulabstractdark

GitHub repoWebsite
Colored dots linked by thin lines behind a landing page header, confetti flying above an "Order placed" message, and stars, hexagons and circles drifting upward.
Made by AgentGid with tsparticles 4.5.3 and @tsparticles/confetti 4.5.3 (npm tarballs, hashes checked against the registry). tsParticles is MIT-licensed, which allows showing and passing on its output and files with the notice kept; the page text in the picture is made up.

2. Commercial use: raw.githubusercontent.com

“to use, copy, modify, merge, publish, distribute, sublicense, and/or sell”

MIT allows commercial use.

raw.githubusercontent.com

License checked Nov 10, 2026 against 1 official page. Tap a verdict to see its source. How we checked Report an error

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 you can 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 Idea

Add falling snow, stars or fireworks to a holiday sale banner for a few weeks, then switch it off.

tsParticles popularity

36 / 100
Gid Score, same scale as developer tools
9,101
GitHub stars
134.4K
npm downloads, last 7 days
+8.1% in 4 weeks
1
AI-agent projects using it, from our repo scan of 4,817
tsParticles: downloads per weeknpm, tsparticles 134,428
tsParticles: GitHub starstsparticles/tsparticles 9,101

Downloads from api.npmjs.org, stars from GitHub, checked Nov 17, 2026. How the Gid Score is calculated

How to start

Tell your AI assistant

“Add a tsParticles background behind our hero section with @tsparticles/engine and @tsparticles/slim pinned to 4.5.3, colors set through particles.paint.fill, fullScreen off, and @tsparticles/plugin-motion loaded so motion stops for prefers-reduced-motion users.”

Or install it yourself. The slim bundle is the usual choice.

pnpm add @tsparticles/engine @tsparticles/slim
Show codeStep 1 or Step 2

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 } } } });

Mistakes to avoid

particles: { color: { value: ["#3b5bdb", "#12b886"] } } in version 4 to color the dots
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.

Installing only @tsparticles/engine and calling tsParticles.load()
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.

Leaving fullScreen at its default when the effect should sit inside one section
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.

Mounting ParticlesProvider inside a page or a component that can unmount
Put ParticlesProvider once at the app root (main.tsx or layout.tsx)

Re-mounting it throws an error or is silently ignored.

Adding motion: { disable: true } to a slim or full bundle setup and expecting it to work
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.

License

MIT license. 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.

Commercial use
Yes

“to use, copy, modify, merge, publish, distribute, sublicense, and/or sell” raw.githubusercontent.com

Credit
Not needed

“The above copyright notice and this permission notice shall be included in all” raw.githubusercontent.com

Inside your app or game
Can ship inside your app

“to use, copy, modify, merge, publish, distribute, sublicense, and/or sell” raw.githubusercontent.com

Pass the files on to your users
Allowed

“to use, copy, modify, merge, publish, distribute, sublicense, and/or sell” raw.githubusercontent.com

AI training
Not stated
Bots and bulk downloads
Not stated

AllowedWith conditionsNot allowedNot stated or not checked yet

Is tsParticles free for commercial use? The full answer Not legal advice. Check the license page before you ship.

For your agent

License rules tell your agent what it may do with tsParticles. Paste them into your prompt or AGENTS.md.

License rules
- 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/)
Can an agent use it by itself?
Yes.

Agent installs a package or loads it from a CDN.

Install
npm install tsparticles
How an agent gets files
npm install @tsparticles/engine plus a preset or bundle (e.g. tsparticles), then load a JSON options object.

Formats: js, json

API, key or account
Not needed. Everything runs on your side.
MCP server
None found
Credit line, if you want one
Particles: tsParticles (particles.js.org), MIT License
This card for machines

Alternatives

tsParticles This page

Free Commercial OK npm

Vanta.js

Pick Vanta.js for ready 3D backgrounds such as waves, birds, fog or a globe, set up in a few lines.

Free Commercial OK npm

Granim.js

Pick Granim.js for a tiny, calm animated color gradient instead of moving particles.

Free Commercial OK npm

ShaderGradient

Pick ShaderGradient for smooth 3D gradient backgrounds designed in a web editor and exported to React.

Free Commercial OK npm

three.js examples

Hundreds of official three.js WebGL/WebGPU examples (shaders, particles, post-processing, loaders) with full source in the repo's examples folder.

Free Commercial OK npm

React Three Fiber examples

Gallery of React Three Fiber scenes (shaders, portals, caustics, scroll, physics, glass) linked to runnable sandboxes with source.

Free Commercial OK npm

All video references and motion backgrounds

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.