Skip to content
This repository was archived by the owner on Apr 15, 2026. It is now read-only.

Latest commit

 

History

History

README.md

banner

tsParticles Snow Preset

jsDelivr npmjs npmjs GitHub Sponsors

tsParticles preset creating a snow effect with falling particles.

Discord Telegram

tsParticles Product Hunt

Sample

demo

Quick checklist

  1. Install @tsparticles/engine (or use the CDN bundle below)
  2. Call loadSnowPreset(tsParticles) before tsParticles.load(...)
  3. Set preset: "snow" in options

How to use it

CDN / Vanilla JS / jQuery

<script src="https://cdn.jsdelivr.net/npm/@tsparticles/preset-snow@3/tsparticles.preset.snow.bundle.min.js"></script>

Usage

Once the scripts are loaded you can set up tsParticles like this:

(async () => {
  await loadSnowPreset(tsParticles);

  await tsParticles.load({
    id: "tsparticles",
    options: {
      preset: "snow",
    },
  });
})();

Customization

Important ⚠️ You can override all the options defining the properties like in any standard tsParticles installation.

tsParticles.load({
  id: "tsparticles",
  options: {
    particles: {
      shape: {
        type: "square", // starting from v2, this require the square shape script
      },
    },
    preset: "snow",
  },
});

Like in the sample above, the circles will be replaced by squares.

Frameworks with a tsParticles component library

Checkout the documentation in the component library repository and call the loadSnowPreset function instead of loadFull, loadSlim or similar functions.

The options shown above are valid for all the component libraries.

Dependencies

This preset loads and combines the following packages:

Package Role in this preset README
@tsparticles/basic Base runtime bundle used by the preset https://www.npmjs.com/package/@tsparticles/basic
@tsparticles/engine tsParticles engine and preset registration https://www.npmjs.com/package/@tsparticles/engine
@tsparticles/palette-snowfall Default snowfall color palette https://www.npmjs.com/package/@tsparticles/palette-snowfall
@tsparticles/updater-wobble Adds side-to-side wobble motion https://www.npmjs.com/package/@tsparticles/updater-wobble

If you want to customize one specific behavior, start from the related package README above.

Common pitfalls

  • Calling tsParticles.load(...) before loadSnowPreset(tsParticles)
  • Changing particle shape without loading the corresponding shape package
  • The snow effect has a transparent background by default; set background.color if you need a specific backdrop

Related docs


flowchart TD

subgraph b [Bundles]
bb[tsParticles Basic]
end

subgraph u [Updaters]
uwo[Wobble]
end

bb --> u

subgraph pr [Presets]
prsn[Snow]
end

bb & uwo --> prsn
Loading