# tsparticles/tsparticles

tsParticles - Easily create highly customizable JavaScript particles effects, confetti explosions and fireworks animations and use them as animated backgrounds for your website. Ready to use components available for React.js, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Inferno, Solid, Riot and Web Components.

Repository: https://github.com/tsparticles/tsparticles
Canonical: https://ross.abutalabs.com/products/tsparticles
Homepage: https://particles.js.org
Language: TypeScript
License: MIT
License Family: permissive
Topics: particles, typescript, npm, javascript, animations, web, tsparticles, angular, svelte, confetti, hacktoberfest, fireworks, canvas, js, react, vue, bg, ts, 2d, html
Last push: 2026-08-13T07:05:44+00:00

## Health v2 (maintenance only)
Score: 96/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 91, longevity 100
- inputs: {"age_days": 2401, "days_push": 20, "days_rel": 63, "gap_med": 2, "n_releases_24m": 10}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 8966, forks 945 (observed 2026-08-28T04:10:26.527148+00:00)

## What it is
tsParticles is a lightweight, dependency-free TypeScript library for creating customizable particle effects, confetti explosions, and fireworks animations on HTML canvas. It ships framework wrappers for React, Vue, Angular, Svelte, Solid, jQuery, Web Components, and more, with modular bundles to control bundle size.

## Use cases
- add animated particle backgrounds to a website
- create confetti explosion effects on button clicks
- render fireworks animations on a landing page
- add interactive particle effects to a React app
- create a particles.js-style background in Vue or Angular
- build custom canvas particle shapes and interactions

## When to choose
- you need decorative particle, confetti, or fireworks effects in a web app
- you want framework wrappers for React, Vue, Angular, Svelte, or Web Components
- you need fine-grained control over bundle size via modular packages
- you want a maintained, actively developed successor to particles.js

## When to avoid
- you need 3D particle systems or WebGL/GPU-accelerated effects
- you want a full animation suite beyond particles (e.g., GSAP-style timelines)
- you need effects outside the browser, such as native mobile or server-side rendering of particles
- you require zero JavaScript for the visual effect

## Facets
- artifact type: library
- maturity: stable
- function: animation, ui-components, graphics
- domain: frontend, web-development, graphics
- platform: browser
- tags: particles, confetti, fireworks, canvas, typescript, animated-backgrounds, react, vue, angular, svelte, nodejs, web-server

## Member repositories
- tsparticles/tsparticles (main) score 96

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:26.527148+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:24:26.551598+00:00, confidence not recorded.
  - readme: https://github.com/tsparticles/tsparticles (fetched 2026-08-28T04:10:26.527148+00:00, sha ef3023e9450c)
  - homepage: https://particles.js.org (fetched 2026-08-29T08:24:55.741827+00:00, sha 86a3464165a8)
  - site_page: https://particles.js.org/guide/getting-started (fetched 2026-08-29T08:24:55.744714+00:00, sha 75193a272a7b)
  - site_page: https://particles.js.org/guide/installation (fetched 2026-08-29T08:24:55.746693+00:00, sha d9dd53b29dbb)
- Data as of 2026-08-30T08:39:29.467469+00:00.