finds.dev

crashmax-dev/fireworks-js

🎆 A simple fireworks library! Ready to use components available for React, Vue 3, Svelte, Angular, Preact, Solid, and Web Components.

View on GitHubHomepage ↗

★ 1,388TypeScriptMITupdated Jul 2024

// the take

fireworks-js is a small canvas-based fireworks animation library with zero dependencies, plus thin wrapper packages for React, Vue, Svelte, Angular, Preact, Solid, and plain Web Components. It's aimed at people who want a quick decorative effect (landing pages, celebration screens, New Year countdown sites) rather than anything resembling a particle engine for games.

Genuinely zero runtime dependencies and ~3kB gzipped, so it won't bloat a bundle. The options API (hue, decay, gravity, particle count, mouse interaction, sound) covers the customization most people actually want without needing to touch the source. Shipping separate thin packages per framework instead of one kitchen-sink package is the right call for tree-shaking and keeps each integration simple.

No commits since mid-2024, and the README itself admits it documents an 'upcoming v2' while the actual npm releases and behavior may not match — that's a bad sign for anyone trying to follow the docs today. It's a single-maintainer project with no visible test suite in the repo, so regressions in the core animation math would likely ship unnoticed. Canvas-only rendering means it's fine for a handful of bursts but will visibly chug if you push particle counts up or run it on a weak device — there's no WebGL path and no documented performance ceiling. The sound feature bundles actual audio files and a volume config, which is scope creep for a 'fireworks' library and one more thing to maintain or strip out if you don't want it.

We read the README, the directory tree and a key source file in October 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
1,388
Forks
95
Language
TypeScript
License
MIT
Last commit
16 Jul 2024

// nearby

If fireworks-js isn't quite it.

All repos →