# @tsparticles/slim

> Slim tsParticles bundle — core engine with essential plugins, presets, and interactions for lightweight particle animations. Ready to use components available for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.

Latest version **4.4.0** (published 2026-08-31) · MIT license · 0 weekly downloads

## Install

```sh
npm install @tsparticles/slim
pnpm add @tsparticles/slim
yarn add @tsparticles/slim
bun add @tsparticles/slim
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 4.4.0 |
| Published | 2026-08-31 |
| First published | 2023-01-20 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 28 |
| Unpacked size | 894.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 8979 |
| Author | Matteo Bruni |
| Maintainers | matteobruni |
| Keywords | front-end, frontend, tsparticles, particles.js, particlesjs, particles, particle, canvas, jsparticles, xparticles, particles-js, particles-bg, particles-bg-vue, particles-ts, particles.ts, react-particles-js, react-particles.js, react-particles, react, reactjs, vue-particles, ngx-particles, angular-particles, particleground, vue, vuejs, preact, preactjs, jquery, angularjs, angular, typescript, javascript, animation, web, html5, web-design, webdesign, css, html, css3, animated, background, confetti, canvas, fireworks, fireworks-js, confetti-js, confettijs, fireworksjs, canvas-confetti |

## Links

- npm: https://www.npmjs.com/package/@tsparticles/slim
- Repository: https://github.com/tsparticles/tsparticles
- Homepage: https://particles.js.org
- Issues: https://github.com/tsparticles/tsparticles/issues
- Funding: https://github.com/sponsors/matteobruni
- npm.io page: https://npm.io/package/@tsparticles/slim

## Dependencies (28)

- [@tsparticles/basic](https://npm.io/package/@tsparticles/basic.md) 4.4.0
- [@tsparticles/engine](https://npm.io/package/@tsparticles/engine.md) 4.4.0
- [@tsparticles/shape-line](https://npm.io/package/@tsparticles/shape-line.md) 4.4.0
- [@tsparticles/shape-star](https://npm.io/package/@tsparticles/shape-star.md) 4.4.0
- [@tsparticles/shape-emoji](https://npm.io/package/@tsparticles/shape-emoji.md) 4.4.0
- [@tsparticles/shape-image](https://npm.io/package/@tsparticles/shape-image.md) 4.4.0
- [@tsparticles/shape-square](https://npm.io/package/@tsparticles/shape-square.md) 4.4.0
- [@tsparticles/updater-life](https://npm.io/package/@tsparticles/updater-life.md) 4.4.0
- [@tsparticles/shape-polygon](https://npm.io/package/@tsparticles/shape-polygon.md) 4.4.0
- [@tsparticles/updater-paint](https://npm.io/package/@tsparticles/updater-paint.md) 4.4.0
- [@tsparticles/updater-rotate](https://npm.io/package/@tsparticles/updater-rotate.md) 4.4.0
- [@tsparticles/plugin-easing-quad](https://npm.io/package/@tsparticles/plugin-easing-quad.md) 4.4.0
- [@tsparticles/plugin-interactivity](https://npm.io/package/@tsparticles/plugin-interactivity.md) 4.4.0
- [@tsparticles/interaction-external-grab](https://npm.io/package/@tsparticles/interaction-external-grab.md) 4.4.0
- [@tsparticles/interaction-external-push](https://npm.io/package/@tsparticles/interaction-external-push.md) 4.4.0
- [@tsparticles/interaction-external-slow](https://npm.io/package/@tsparticles/interaction-external-slow.md) 4.4.0
- [@tsparticles/interaction-external-pause](https://npm.io/package/@tsparticles/interaction-external-pause.md) 4.4.0
- [@tsparticles/interaction-external-bounce](https://npm.io/package/@tsparticles/interaction-external-bounce.md) 4.4.0
- [@tsparticles/interaction-external-bubble](https://npm.io/package/@tsparticles/interaction-external-bubble.md) 4.4.0
- [@tsparticles/interaction-external-remove](https://npm.io/package/@tsparticles/interaction-external-remove.md) 4.4.0
- [@tsparticles/interaction-particles-links](https://npm.io/package/@tsparticles/interaction-particles-links.md) 4.4.0
- [@tsparticles/interaction-external-attract](https://npm.io/package/@tsparticles/interaction-external-attract.md) 4.4.0
- [@tsparticles/interaction-external-connect](https://npm.io/package/@tsparticles/interaction-external-connect.md) 4.4.0
- [@tsparticles/interaction-external-destroy](https://npm.io/package/@tsparticles/interaction-external-destroy.md) 4.4.0
- [@tsparticles/interaction-external-repulse](https://npm.io/package/@tsparticles/interaction-external-repulse.md) 4.4.0
- [@tsparticles/interaction-external-parallax](https://npm.io/package/@tsparticles/interaction-external-parallax.md) 4.4.0
- [@tsparticles/interaction-particles-attract](https://npm.io/package/@tsparticles/interaction-particles-attract.md) 4.4.0
- [@tsparticles/interaction-particles-collisions](https://npm.io/package/@tsparticles/interaction-particles-collisions.md) 4.4.0

## Alternatives

- [@luma.gl/experimental](https://npm.io/package/@luma.gl/experimental.md) — 77.1K weekly downloads
- [persona-harness](https://npm.io/package/persona-harness.md) — 4.7K weekly downloads
- [@tsparticles/effect-bubble](https://npm.io/package/@tsparticles/effect-bubble.md) — 4.6K weekly downloads
- [f3d](https://npm.io/package/f3d.md) — 730 weekly downloads
- [spark-html-motion](https://npm.io/package/spark-html-motion.md) — 298 weekly downloads

## Recent versions

- 4.4.0 (latest) — 2026-08-31
- 4.0.0-beta.17 (beta) — 2026-05-15
- 4.0.0-alpha.28 (alpha) — 2026-03-15
- 3.0.2 (next) — 2023-12-06
- 4.3.2 — 2026-07-10
- 4.3.1 — 2026-07-01
- 4.3.0 — 2026-06-27
- 4.2.1 — 2026-06-19
- 4.2.0 — 2026-06-17
- 4.1.3 — 2026-06-03
- 4.1.2 — 2026-06-01
- 4.1.1 — 2026-05-31
- 4.1.0 — 2026-05-29
- 4.0.5 — 2026-05-19
- 4.0.4 — 2026-05-19
- … 65 more at https://npm.io/package/@tsparticles/slim/versions

## README

[![banner](https://particles.js.org/images/banner2.png)](https://particles.js.org)

# tsParticles Slim Bundle

[![jsDelivr](https://data.jsdelivr.com/v1/package/npm/@tsparticles/slim/badge)](https://www.jsdelivr.com/package/npm/@tsparticles/slim) [![npmjs](https://badge.fury.io/js/@tsparticles/slim.svg)](https://www.npmjs.com/package/@tsparticles/slim) [![npmjs](https://img.shields.io/npm/dt/@tsparticles/slim)](https://www.npmjs.com/package/@tsparticles/slim) [![GitHub Sponsors](https://img.shields.io/github/sponsors/matteobruni)](https://github.com/sponsors/matteobruni)

[tsParticles](https://github.com/tsparticles/tsparticles) slim bundle loads some of the most used features to
a `@tsparticles/engine` instance.

**Included Packages**

- [@tsparticles/basic (and all its dependencies)](https://github.com/tsparticles/tsparticles/tree/main/bundles/basic)
- [@tsparticles/engine](https://github.com/tsparticles/tsparticles/tree/main/engine)
- [@tsparticles/interaction-external-attract](https://github.com/tsparticles/tsparticles/tree/main/interactions/external/attract)
- [@tsparticles/interaction-external-bounce](https://github.com/tsparticles/tsparticles/tree/main/interactions/external/bounce)
- [@tsparticles/interaction-external-bubble](https://github.com/tsparticles/tsparticles/tree/main/interactions/external/bubble)
- [@tsparticles/interaction-external-connect](https://github.com/tsparticles/tsparticles/tree/main/interactions/external/connect)
- [@tsparticles/interaction-external-destroy](https://github.com/tsparticles/tsparticles/tree/main/interactions/external/destroy)
- [@tsparticles/interaction-external-grab](https://github.com/tsparticles/tsparticles/tree/main/interactions/external/grab)
- [@tsparticles/interaction-external-parallax](https://github.com/tsparticles/tsparticles/tree/main/interactions/external/parallax)
- [@tsparticles/interaction-external-pause](https://github.com/tsparticles/tsparticles/tree/main/interactions/external/pause)
- [@tsparticles/interaction-external-push](https://github.com/tsparticles/tsparticles/tree/main/interactions/external/push)
- [@tsparticles/interaction-external-remove](https://github.com/tsparticles/tsparticles/tree/main/interactions/external/remove)
- [@tsparticles/interaction-external-repulse](https://github.com/tsparticles/tsparticles/tree/main/interactions/external/repulse)
- [@tsparticles/interaction-external-slow](https://github.com/tsparticles/tsparticles/tree/main/interactions/external/slow)
- [@tsparticles/interaction-particles-attract](https://github.com/tsparticles/tsparticles/tree/main/interactions/particles/attract)
- [@tsparticles/interaction-particles-collisions](https://github.com/tsparticles/tsparticles/tree/main/interactions/particles/collisions)
- [@tsparticles/interaction-particles-links](https://github.com/tsparticles/tsparticles/tree/main/interactions/particles/links)
- [@tsparticles/plugin-easing-quad](https://github.com/tsparticles/tsparticles/tree/main/plugins/easings/quad)
- [@tsparticles/plugin-interactivity](https://github.com/tsparticles/tsparticles/tree/main/plugins/interactivity)
- [@tsparticles/shape-image](https://github.com/tsparticles/tsparticles/tree/main/shapes/image)
- [@tsparticles/shape-line](https://github.com/tsparticles/tsparticles/tree/main/shapes/line)
- [@tsparticles/shape-polygon](https://github.com/tsparticles/tsparticles/tree/main/shapes/polygon)
- [@tsparticles/shape-square](https://github.com/tsparticles/tsparticles/tree/main/shapes/square)
- [@tsparticles/shape-star](https://github.com/tsparticles/tsparticles/tree/main/shapes/star)
- [@tsparticles/shape-emoji](https://github.com/tsparticles/tsparticles/tree/main/shapes/emoji)
- [@tsparticles/updater-life](https://github.com/tsparticles/tsparticles/tree/main/updaters/life)
- [@tsparticles/updater-rotate](https://github.com/tsparticles/tsparticles/tree/main/updaters/rotate)
- [@tsparticles/updater-paint](https://github.com/tsparticles/tsparticles/tree/main/updaters/paint)

## Dependency Graph

```mermaid
flowchart TD

subgraph b [Bundle]
  bs[tsparticles/slim]
  bb[tsparticles/basic]
end

subgraph c [Core]
  ce[tsparticles/engine]
end

subgraph i [Interactions]
  iea[tsparticles/interaction-external-attract]
  ieb[tsparticles/interaction-external-bounce]
  iebu[tsparticles/interaction-external-bubble]
  iec[tsparticles/interaction-external-connect]
  ied[tsparticles/interaction-external-destroy]
  ieg[tsparticles/interaction-external-grab]
  iepa[tsparticles/interaction-external-parallax]
  iepau[tsparticles/interaction-external-pause]
  iepu[tsparticles/interaction-external-push]
  ier[tsparticles/interaction-external-remove]
  iere[tsparticles/interaction-external-repulse]
  ies[tsparticles/interaction-external-slow]
  ipa[tsparticles/interaction-particles-attract]
  ipc[tsparticles/interaction-particles-collisions]
  ipl[tsparticles/interaction-particles-links]
end

subgraph p [Plugins]
  peq[tsparticles/plugin-easing-quad]
  pint[tsparticles/plugin-interactivity]
end

subgraph s [Shapes]
  se[tsparticles/shape-emoji]
  si[tsparticles/shape-image]
  sl[tsparticles/shape-line]
  sp[tsparticles/shape-polygon]
  ss[tsparticles/shape-square]
  sst[tsparticles/shape-star]
end

subgraph u [Updaters]
  ul[tsparticles/updater-life]
  ur[tsparticles/updater-rotate]
  up[tsparticles/updater-paint]
end

bs --> bb
bs --> ce
bs --> i
bs --> p
bs --> s
bs --> u
```

## Quick checklist

1. Install `@tsparticles/engine` (or use the CDN bundle below)
2. Call the package loader function(s) before `tsParticles.load(...)`
3. Apply the package options in your `tsParticles.load(...)` config

## How to use it

### CDN / Vanilla JS / jQuery

The CDN/Vanilla version JS has two different files:

- One is a bundle file with all the scripts included in a single file
- One is a file including just the `loadSlim` function to load the tsParticles slim preset, all dependencies must be
  included manually

#### Bundle

Including the `tsparticles.slim.bundle.min.js` file will work exactly like `v1`, you can start using the `tsParticles`
instance in the same way.

This is the easiest usage, since it's a single file with the some of the `v1` features.

All new features will be added as external packages, this bundle is recommended for migrating from `v1` easily.

#### Not Bundle

This installation requires more work since all dependencies must be included in the page. Some lines above are all
specified in the **Included Packages** section.

### Usage

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

```javascript
(async () => {
  await loadSlim(tsParticles);

  await tsParticles.load({
    id: "tsparticles",
    options: {/* options */},
  });
})();
```

### React.js / Preact / Inferno

_The syntax for `React.js`, `Preact` and `Inferno` is the same_.

This sample uses the class component syntax, but you can use hooks as well (if the library supports it).

_Class Components_

```typescript jsx
import React from "react";
import Particles from "react-particles";
import type { Engine } from "@tsparticles/engine";
import { loadSlim } from "@tsparticles/slim";

export class ParticlesContainer extends PureComponent<unknown> {
  // this customizes the component tsParticles installation
  async customInit(engine: Engine) {
    // this adds the bundle to tsParticles
    await loadSlim(engine);
  }

  render() {
    const options = {
      /* custom options */
    };

    return <Particles options={options} init={this.customInit} />;
  }
}
```

_Hooks / Functional Components_

```typescript jsx
import React, { useCallback } from "react";
import Particles from "react-particles";
import type { Engine } from "@tsparticles/engine";
import { loadSlim } from "@tsparticles/slim";

export function ParticlesContainer(props: unknown) {
  // this customizes the component tsParticles installation
  const customInit = useCallback(async (engine: Engine) => {
    // this adds the bundle to tsParticles
    await loadSlim(engine);
  });

  const options = {
    /* custom options */
  };

  return <Particles options={options} init={this.customInit} />;
}
```

### Vue (2.x and 3.x)

_The syntax for `Vue.js 2.x` and `3.x` is the same_

```vue
<Particles id="tsparticles" :particlesInit="particlesInit" :options="options" />
```

```js
const options = {
  /* custom options */
};

async function particlesInit(engine: Engine) {
  await loadSlim(engine);
}
```

### Angular

```html
<ng-particles [id]="id" [options]="options" [particlesInit]="particlesInit"></ng-particles>
```

```ts
const options = {/* custom options */};

async function particlesInit(engine: Engine): void {
  await loadSlim(engine);
}
```

### Svelte

```sveltehtml

<Particles
    id="tsparticles"
    options={options}
    particlesInit="{particlesInit}"
/>
```

```js
let options = {/* custom options */};

let particlesInit = async engine => {
  await loadSlim(engine);
};
```

## Common pitfalls

- Calling `tsParticles.load(...)` before `loadSlim(...)`
- Verify required peer packages before enabling advanced options
- Change one option group at a time to isolate regressions quickly

## Related docs

- All packages catalog: <https://github.com/tsparticles/tsparticles>
- Main docs: <https://particles.js.org/docs/>

---
_Source: https://npm.io/package/@tsparticles/slim · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._