{
 "slug": "tsparticles",
 "name": "tsParticles",
 "author": "Matteo Bruni",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "Particle, confetti and fireworks backgrounds for websites with many presets and React/Vue/Angular/Svelte wrappers.",
 "category": {
  "slug": "video-backgrounds",
  "name": "Video references and motion backgrounds"
 },
 "tags": [
  "Code library",
  "Open source"
 ],
 "styles": [
  "playful",
  "abstract",
  "dark"
 ],
 "logo_url": "https://agentgid.com/media/avatars/tsparticles.png",
 "logo_letter": "T",
 "links": {
  "repo": "https://github.com/tsparticles/tsparticles",
  "website": "https://particles.js.org",
  "api_docs": null
 },
 "preview": {
  "kind": "image_grid",
  "src": "https://agentgid.com/assets/tsparticles/demo.jpg",
  "alt": "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.",
  "caption": "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."
 },
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Fully free.",
   "source": {
    "label": "particles.js.org",
    "url": "https://particles.js.org"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "MIT",
   "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell",
   "note": "MIT allows commercial use.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/tsparticles/tsparticles/main/LICENSE"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": "Keep the notice in code copies",
   "quote": "The above copyright notice and this permission notice shall be included in all",
   "note": "No credit on screen. Keep the license notice inside the code you ship.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/tsparticles/tsparticles/main/LICENSE"
   },
   "n": 3
  },
  {
   "key": "agent_access",
   "label": "Agent access",
   "value": "npm package",
   "status": "info",
   "sub": "Installs without a key",
   "quote": null,
   "note": "An agent can install it by itself with npm install tsparticles. No key or account is needed.",
   "source": {
    "label": "github.com/tsparticles/tsparticles",
    "url": "https://github.com/tsparticles/tsparticles"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "MIT",
  "url": "https://raw.githubusercontent.com/tsparticles/tsparticles/main/LICENSE",
  "summary": "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.",
  "pages_read": 1,
  "rules": [
   "Keep the MIT notice if you redistribute the code.",
   "Respect prefers-reduced-motion."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/tsparticles/tsparticles/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "The above copyright notice and this permission notice shall be included in all",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/tsparticles/tsparticles/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Can ship inside your app",
    "status": "yes",
    "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/tsparticles/tsparticles/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "Allowed",
    "status": "yes",
    "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/tsparticles/tsparticles/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "AI training",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Bots and bulk downloads",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   }
  ],
  "checked_at": "2026-11-10",
  "commercial_use_page": "https://agentgid.com/assets/tsparticles/commercial-use/"
 },
 "overview": {
  "heading": "tsParticles: moving particle backgrounds and confetti for sites",
  "body": "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."
 },
 "uses": [
  {
   "title": "Moving background behind a page header",
   "text": "Put softly moving, connected dots behind the headline of a landing page or sign-up screen, in your brand colors.",
   "idea": false,
   "image": null
  },
  {
   "title": "Confetti when something succeeds",
   "text": "Fire a burst of confetti when a user finishes sign-up, places an order or reaches a goal, with one line of code.",
   "idea": false,
   "image": null
  },
  {
   "title": "Particles in a React app",
   "text": "Add the same background as a component in a React or Next.js app, with the effect loaded once for the whole app.",
   "idea": false,
   "image": null
  },
  {
   "title": "Calmer pages for motion-sensitive visitors",
   "text": "Slow down or stop the animation for visitors who asked their device for less motion, so the page stays comfortable.",
   "idea": false,
   "image": null
  },
  {
   "title": "Replace an old particles.js setup",
   "text": "Move an older site that used the particles.js library to the maintained tsParticles, keeping its settings.",
   "idea": false,
   "image": null
  },
  {
   "title": "Festive seasonal banner",
   "text": "Add falling snow, stars or fireworks to a holiday sale banner for a few weeks, then switch it off.",
   "idea": true,
   "image": null
  }
 ],
 "start": {
  "prompt": "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.",
  "install": "pnpm add @tsparticles/engine @tsparticles/slim",
  "install_note": "The slim bundle is the usual choice.",
  "code": [
   {
    "tab": "Step 1",
    "intro": "Load the bundle into the engine first, then start the animation in an element with an id.",
    "source": "import { tsParticles } from \"@tsparticles/engine\";\nimport { loadSlim } from \"@tsparticles/slim\";\nawait loadSlim(tsParticles);\nawait tsParticles.load({ id: \"tsparticles\", options: { particles: { links: { enable: true }, move: { enable: true } } } });"
   },
   {
    "tab": "Step 2",
    "intro": "For confetti alone, the confetti package has its own one-call function and needs no engine setup.",
    "source": "pnpm add @tsparticles/confetti"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "particles: { color: { value: [\"#3b5bdb\", \"#12b886\"] } } in version 4 to color the dots",
   "fix": "particles: { paint: { fill: { enable: true, color: { value: [\"#3b5bdb\", \"#12b886\"] } } } }",
   "why": "In our 4.5.3 demo the color option left the dots white (the paint default) while paint.fill colored them.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Installing only @tsparticles/engine and calling tsParticles.load()",
   "fix": "Install a bundle too and await loadSlim(tsParticles) (or loadBasic, loadFull, loadAll) before load()",
   "why": "The engine has no shapes or movement of its own, so the canvas stays blank.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Leaving fullScreen at its default when the effect should sit inside one section",
   "fix": "Set fullScreen: { enable: false } and size the container element with CSS",
   "why": "fullScreen is on by default, so the canvas covers the whole window instead of the header box.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Mounting ParticlesProvider inside a page or a component that can unmount",
   "fix": "Put ParticlesProvider once at the app root (main.tsx or layout.tsx)",
   "why": "Re-mounting it throws an error or is silently ignored.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Adding motion: { disable: true } to a slim or full bundle setup and expecting it to work",
   "fix": "Install @tsparticles/plugin-motion and await loadMotionPlugin(tsParticles) before load(); the confetti bundle already includes it",
   "why": "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.",
   "dont_code": false,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": true,
  "self_serve_text": "Agent installs a package or loads it from a CDN",
  "install": "npm install tsparticles",
  "repo": "https://github.com/tsparticles/tsparticles",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_files": "npm install @tsparticles/engine plus a preset or bundle (e.g. tsparticles), then load a JSON options object.",
  "formats": [
   "js",
   "json"
  ],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": "Particles: tsParticles (particles.js.org), MIT License",
  "rules_text": "- 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.\n  Connect: npm tsparticles.\n  Get files: npm install @tsparticles/engine plus a preset or bundle (e.g. tsparticles), then load a JSON options object (js, json).\n  Rule: Keep the MIT notice if you redistribute the code.\n  Rule: Respect prefers-reduced-motion.\n  License: https://raw.githubusercontent.com/tsparticles/tsparticles/main/LICENSE (checked 2026-11-10; details: https://agentgid.com/assets/tsparticles/)",
  "agent_md": "https://agentgid.com/assets/tsparticles/agent.md",
  "card_json": "https://agentgid.com/assets/tsparticles/card.json"
 },
 "popularity": {
  "gid_score": 36,
  "stars": 9101,
  "downloads_7d": 134428,
  "downloads_7d_label": "134.4K",
  "downloads_change_4w_pct": 8.1,
  "eco": "npm",
  "package": "tsparticles",
  "repo": "tsparticles/tsparticles",
  "agent_projects": 1,
  "agent_projects_total": 4817,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [
    [
     "2025-11-17",
     75075
    ],
    [
     "2025-11-24",
     72380
    ],
    [
     "2025-12-01",
     80587
    ],
    [
     "2025-12-08",
     77741
    ],
    [
     "2025-12-15",
     72321
    ],
    [
     "2025-12-22",
     45929
    ],
    [
     "2025-12-29",
     44691
    ],
    [
     "2026-01-05",
     72498
    ],
    [
     "2026-01-12",
     77193
    ],
    [
     "2026-01-19",
     79315
    ],
    [
     "2026-01-26",
     83937
    ],
    [
     "2026-02-02",
     89386
    ],
    [
     "2026-02-09",
     88821
    ],
    [
     "2026-02-16",
     103151
    ],
    [
     "2026-02-23",
     103338
    ],
    [
     "2026-03-02",
     97866
    ],
    [
     "2026-03-09",
     124709
    ],
    [
     "2026-03-16",
     122180
    ],
    [
     "2026-03-23",
     132093
    ],
    [
     "2026-03-30",
     101561
    ],
    [
     "2026-04-06",
     95801
    ],
    [
     "2026-04-13",
     99929
    ],
    [
     "2026-04-20",
     97499
    ],
    [
     "2026-04-27",
     106421
    ],
    [
     "2026-05-04",
     101067
    ],
    [
     "2026-05-11",
     106597
    ],
    [
     "2026-05-18",
     108287
    ],
    [
     "2026-05-25",
     4149532
    ],
    [
     "2026-06-01",
     475408
    ],
    [
     "2026-06-08",
     1969155
    ],
    [
     "2026-06-15",
     103064
    ],
    [
     "2026-06-22",
     104453
    ],
    [
     "2026-06-29",
     88750
    ],
    [
     "2026-07-06",
     98363
    ],
    [
     "2026-07-13",
     99907
    ],
    [
     "2026-07-20",
     113220
    ],
    [
     "2026-07-27",
     103153
    ],
    [
     "2026-08-03",
     114405
    ],
    [
     "2026-08-10",
     114827
    ],
    [
     "2026-08-17",
     119647
    ],
    [
     "2026-08-24",
     109931
    ],
    [
     "2026-08-31",
     118471
    ],
    [
     "2026-09-07",
     78174
    ],
    [
     "2026-09-14",
     106509
    ],
    [
     "2026-09-21",
     123130
    ],
    [
     "2026-09-28",
     128709
    ],
    [
     "2026-10-05",
     108424
    ],
    [
     "2026-10-12",
     95460
    ],
    [
     "2026-10-19",
     91578
    ],
    [
     "2026-10-26",
     139838
    ],
    [
     "2026-11-02",
     126596
    ],
    [
     "2026-11-09",
     134428
    ]
   ],
   "stars": [
    [
     "2026-11-07",
     9078
    ],
    [
     "2026-11-08",
     9078
    ],
    [
     "2026-11-09",
     9078
    ],
    [
     "2026-11-10",
     9079
    ],
    [
     "2026-11-11",
     9082
    ],
    [
     "2026-11-12",
     9084
    ],
    [
     "2026-11-13",
     9088
    ],
    [
     "2026-11-14",
     9090
    ],
    [
     "2026-11-15",
     9095
    ],
    [
     "2026-11-16",
     9098
    ],
    [
     "2026-11-17",
     9101
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-17"
 },
 "alternatives": [
  {
   "slug": "tsparticles",
   "name": "tsParticles",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "vanta-js",
   "name": "Vanta.js",
   "why": "Pick Vanta.js for ready 3D backgrounds such as waves, birds, fog or a globe, set up in a few lines.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "granim-js",
   "name": "Granim.js",
   "why": "Pick Granim.js for a tiny, calm animated color gradient instead of moving particles.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "shadergradient",
   "name": "ShaderGradient",
   "why": "Pick ShaderGradient for smooth 3D gradient backgrounds designed in a web editor and exported to React.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "threejs-examples",
   "name": "three.js examples",
   "why": "Hundreds of official three.js WebGL/WebGPU examples (shaders, particles, post-processing, loaders) with full source in the repo's examples folder.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "react-three-fiber-examples",
   "name": "React Three Fiber examples",
   "why": "Gallery of React Three Fiber scenes (shaders, portals, caustics, scroll, physics, glass) linked to runnable sandboxes with source.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  }
 ],
 "faq": [
  {
   "q": "Can I use tsParticles on a client's or a paid site?",
   "a": "Yes. The MIT license allows commercial use; keep the license notice with copies of the code."
  },
  {
   "q": "Which bundle should I install?",
   "a": "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."
  },
  {
   "q": "Does the confetti respect visitors who prefer less motion?",
   "a": "Yes, the confetti bundle includes the motion add-on, which follows the reduced-motion setting."
  },
  {
   "q": "Are there ready-made looks?",
   "a": "Yes, a configs package holds dozens of ready settings such as snow, stars and bubbles that you load by name."
  }
 ],
 "at_a_glance": {
  "latest_version": "4.5.3",
  "last_release": "2026-08-31",
  "last_commit": "2026-11-17",
  "runtime": "A browser (canvas); @tsparticles/react needs react and react-dom >=16.8.0; all @tsparticles packages on the same version",
  "key_needed": false,
  "formats": "js, json"
 },
 "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."
 ],
 "stack_snippets": [],
 "claims": [],
 "checked": {
  "license_read": "2026-11-10",
  "overview_checked": "2026-11-10",
  "numbers_updated": "2026-11-17",
  "sources": [
   {
    "label": "particles.js.org",
    "url": "https://particles.js.org/"
   },
   {
    "label": "particles.js.org/llms.txt",
    "url": "https://particles.js.org/llms.txt"
   },
   {
    "label": "particles.js.org/guide/getting-started",
    "url": "https://particles.js.org/guide/getting-started"
   },
   {
    "label": "particles.js.org/guide/installation",
    "url": "https://particles.js.org/guide/installation"
   },
   {
    "label": "particles.js.org/guide/bundles-confetti",
    "url": "https://particles.js.org/guide/bundles-confetti"
   },
   {
    "label": "particles.js.org/guide/wrappers",
    "url": "https://particles.js.org/guide/wrappers"
   },
   {
    "label": "particles.js.org/guide/wrappers-react",
    "url": "https://particles.js.org/guide/wrappers-react"
   },
   {
    "label": "particles.js.org/guide/troubleshooting",
    "url": "https://particles.js.org/guide/troubleshooting"
   },
   {
    "label": "particles.js.org/guide/mcp-server",
    "url": "https://particles.js.org/guide/mcp-server"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/tsparticles/tsparticles/blob/main/README.md"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/tsparticles/tsparticles/blob/main/LICENSE"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/tsparticles/tsparticles/blob/main/wrappers/react/README.md"
   },
   {
    "label": "github.com/tsparticles/tsparticles/blob/main/markdown/Options.md",
    "url": "https://github.com/tsparticles/tsparticles/blob/main/markdown/Options.md"
   },
   {
    "label": "github.com/tsparticles/tsparticles/blob/main/markdown/Options/Motion.md",
    "url": "https://github.com/tsparticles/tsparticles/blob/main/markdown/Options/Motion.md"
   },
   {
    "label": "github.com/tsparticles/tsparticles/blob/main/markdown/Options/FullScreen.md",
    "url": "https://github.com/tsparticles/tsparticles/blob/main/markdown/Options/FullScreen.md"
   },
   {
    "label": "github.com/tsparticles/tsparticles/blob/main/markdown/Options/Plugins/Motion.md",
    "url": "https://github.com/tsparticles/tsparticles/blob/main/markdown/Options/Plugins/Motion.md"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/tsparticles/tsparticles/blob/main/plugins/motion/README.md"
   },
   {
    "label": "github.com/tsparticles/tsparticles/blob/main/markdown/Options/Particles.md",
    "url": "https://github.com/tsparticles/tsparticles/blob/main/markdown/Options/Particles.md"
   },
   {
    "label": "github.com/tsparticles/tsparticles/blob/main/markdown/Options/Particles/Paint.md",
    "url": "https://github.com/tsparticles/tsparticles/blob/main/markdown/Options/Particles/Paint.md"
   },
   {
    "label": "npm: tsparticles/latest",
    "url": "https://registry.npmjs.org/tsparticles/latest"
   },
   {
    "label": "npm: tsparticles/4.5.3",
    "url": "https://registry.npmjs.org/tsparticles/4.5.3"
   },
   {
    "label": "npm: @tsparticles/engine/latest",
    "url": "https://registry.npmjs.org/@tsparticles/engine/latest"
   },
   {
    "label": "npm: @tsparticles/slim/latest",
    "url": "https://registry.npmjs.org/@tsparticles/slim/latest"
   },
   {
    "label": "npm: @tsparticles/confetti/4.5.3",
    "url": "https://registry.npmjs.org/@tsparticles/confetti/4.5.3"
   },
   {
    "label": "npm: @tsparticles/react/latest",
    "url": "https://registry.npmjs.org/@tsparticles/react/latest"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/tsparticles/tsparticles/main/LICENSE"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/tsparticles/",
 "note": "Written by AgentGid from the official pages in checked.sources; quotes are copied from those pages. status: yes | cond | no | unknown | info. Prices and vendor claims are as reported on the checked date. Not legal advice."
}
