DEV Community

Cover image for Preparing tsParticles v3
Matteo Bruni for tsParticles

Posted on • Updated on


Preparing tsParticles v3

I'm preparing tsParticles version 3, and some breaking changes will come.

It's expected to have breaking changes between major releases, but this time I want to start talking about them before the final release.

What's the difference between v2 and v3?

The main difference between v2 and v3 is the package naming system. Instead of the generic tsparticles- prefix, the official packages will be part of the @tsparticles organization.

Every package, except tsparticles and the existing @tsparticles/ packages, will change the name, and all the older ones will be deprecated after 3.1 will come out (I don't know when it will happen, 3.0 is still not ready).

Maybe other changes will occur, but nothing breaking yet.

The new repositories

Since this naming is a huge change, I decided also to split the mono repository. A 100+ project mono repository is too big, and the maintainability is not the best.

Everyone that want to help on the React (for example) component had to figure out how to build this massive project, and this is not helping newcomers to join the project.

Now every front end framework has its own repository, the full list here:

Vue 2.x and Vue 3.x are separated because Vue 2.x is completely different from Vue 3.x, and that's why I decided to use two different repositories.

Everyone is welcome to contribute to them now, and it's easier to give them support for starting contributing.

For the creative people, also the presets now have a new repository:

It's easier to find presets, and to start creating a new one without knowing the whole monorepository. You have to deal only with options.

And last but not least, the two websites ( and have two dedicated repositories:

The changelog

Since v3 is under development, you can check the PR on GitHub, the changelog there is kept up to date. I'll post updates here too as soon as possible

Thanks to everyone that is supporting the project, even only with a star on GitHub, now you have more stars to place 🤩

I'll leave the socials here, so we can keep in touch for any question or help for contributing to tsParticles repositories

GitHub logo matteobruni / 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.


tsParticles - TypeScript Particles

A lightweight TypeScript library for creating particles. Dependency free (*), browser ready and compatible with React.js, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Inferno, Riot.js, Solid.js, and Web Components

GitHub Sponsors jsDelivr hits (npm) Cdnjs npm npm lerna CodeFactor Codacy Badge Rate this package Gitpod Ready-to-Code Run on

Discord Slack WhatsApp Telegram Reddit

tsParticles Product Hunt Buy Me A Coffee Linktree

Table of Contents

⚠️⚠️ _This readme refers to v2 version, read here for v1 documentation* ⚠️⚠️

Do you want to use it on your website?

Documentation and Development references here 📖

This library is

Top comments (1)

jollenmoyani profile image
Jollen Moyani

Amazing staff

Welcome! 👋 Every week new members join DEV and share a bit about them in our Welcome Thread!  

Welcome them to DEV and share a bit about yourself.