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

1. Price: particles.js.org
Fully free.
particles.js.orgNo quote yet: price is read from the official pages.
2. Commercial use: raw.githubusercontent.com
“to use, copy, modify, merge, publish, distribute, sublicense, and/or sell”
MIT allows commercial use.
raw.githubusercontent.com3. Credit the author: raw.githubusercontent.com
“The above copyright notice and this permission notice shall be included in all”
No credit on screen. Keep the license notice inside the code you ship.
raw.githubusercontent.com4. Agent access: github.com/tsparticles/tsparticles
An agent can install it by itself with npm install tsparticles. No key or account is needed.
github.com/tsparticles/tsparticlesLicense 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
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 } } } });
For confetti alone, the confetti package has its own one-call function and needs no engine setup.
pnpm add @tsparticles/confetti
Mistakes to avoid
In our 4.5.3 demo the color option left the dots white (the paint default) while paint.fill colored them.
The engine has no shapes or movement of its own, so the canvas stays blank.
fullScreen is on by default, so the canvas covers the whole window instead of the header box.
Re-mounting it throws an error or is silently ignored.
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.
“to use, copy, modify, merge, publish, distribute, sublicense, and/or sell” raw.githubusercontent.com
“The above copyright notice and this permission notice shall be included in all” raw.githubusercontent.com
“to use, copy, modify, merge, publish, distribute, sublicense, and/or sell” raw.githubusercontent.com
“to use, copy, modify, merge, publish, distribute, sublicense, and/or sell” raw.githubusercontent.com
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.
- 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/)
Agent installs a package or loads it from a CDN.
npm install tsparticlesFormats: js, json
Particles: tsParticles (particles.js.org), MIT LicenseAlternatives
tsParticles This page
Pick Vanta.js for ready 3D backgrounds such as waves, birds, fog or a globe, set up in a few lines.
Pick Granim.js for a tiny, calm animated color gradient instead of moving particles.
Pick ShaderGradient for smooth 3D gradient backgrounds designed in a web editor and exported to React.
Hundreds of official three.js WebGL/WebGPU examples (shaders, particles, post-processing, loaders) with full source in the repo's examples folder.
Gallery of React Three Fiber scenes (shaders, portals, caustics, scroll, physics, glass) linked to runnable sandboxes with source.
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.