# loonywizard/js-confetti

JS Confetti library that supports emojis 🦄 🎉 ⚡️

Repository: https://github.com/loonywizard/js-confetti
Canonical: https://ross.abutalabs.com/products/js-confetti
Homepage: https://loonywizard.github.io/js-confetti/
Language: TypeScript
License: MIT
License Family: permissive
Topics: js-confetti, confetti, canvas, animation, canvas-confetti
Last push: 2025-09-02T21:27:08+00:00

## Health v2 (maintenance only)
Score: 41/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 40, release rhythm 8, longevity 100
- inputs: {"age_days": 2017, "days_push": 365, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1293, forks 56 (observed 2026-08-28T04:04:16.249239+00:00)

## What it is
A zero-dependency JavaScript confetti animation library that renders colorful confetti and emoji particles on an HTML canvas. It works out of the box with sensible defaults while allowing customization of colors, emojis, size, count, and dispatch position.

## Use cases
- add confetti animation when user completes a form or checkout
- celebrate success with emoji confetti in a web app
- fire confetti on button click at mouse position
- add a fun celebration effect to a landing page
- show confetti when a game level is won

## When to choose
- you want a tiny, zero-dependency confetti effect with no configuration
- you need emoji-based confetti or custom colors and sizes
- you want TypeScript typings and a simple Promise-based API

## When to avoid
- you need physics-accurate particle systems or complex visual effects
- you are building a non-browser environment like Node.js server-side rendering without a DOM canvas
- you need confetti effects in native mobile or desktop apps

## Facets
- artifact type: library
- maturity: active
- function: animation, ui-components
- domain: frontend, web-development
- platform: browser, cross-platform
- tags: confetti, canvas, emoji, zero-dependencies, typescript, celebration-effects, nodejs

## Member repositories
- loonywizard/js-confetti (main) score 41

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:16.249239+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-30T04:54:42.404093+00:00, confidence not recorded.
  - readme: https://github.com/loonywizard/js-confetti (fetched 2026-08-28T04:04:16.249239+00:00, sha e97bea7f6f76)
  - homepage: https://loonywizard.github.io/js-confetti/ (fetched 2026-08-29T12:11:21.202283+00:00, sha c6615945d6ba)
  - registry_npm: https://registry.npmjs.org/js-confetti (fetched 2026-08-29T12:11:21.211366+00:00, sha dc8504bf589b)
- Data as of 2026-08-30T08:39:29.467469+00:00.