Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/workflows/deploy-websites.yml
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ permissions:

env:
NX_CLOUD_ACCESS_TOKEN: "${{ secrets.NX_CLOUD_ACCESS_TOKEN }}"
NODE_OPTIONS: "--max-old-space-size=4096"

jobs:
build-and-deploy:
Expand Down
1 change: 1 addition & 0 deletions .github/workflows/nodejs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ env:
NODE_VERSION: "24"
NX_CLOUD_ACCESS_TOKEN: "${{ secrets.NX_CLOUD_ACCESS_TOKEN }}"
firebaseToken: "${{ secrets.FIREBASE_SERVICE_ACCOUNT_TSPARTICLES }}"
NODE_OPTIONS: "--max-old-space-size=4096"

jobs:
build-and-deploy:
Expand Down
3 changes: 1 addition & 2 deletions .github/workflows/npm-publish.yml
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ env:
RELEASE_UPLOAD_RETRIES: 6
RELEASE_RETRY_BASE_DELAY: 10
IS_STABLE: ${{ !contains(github.ref, '-alpha.') && !contains(github.ref, '-beta.') }}
NODE_OPTIONS: "--max-old-space-size=4096"

jobs:
publish:
Expand Down Expand Up @@ -51,8 +52,6 @@ jobs:

- name: Build All Packages
run: pnpm run build:ci
env:
CI: true

# 📦 ZIP artifacts (solo stable)
- name: Generate zip artifacts
Expand Down
2 changes: 1 addition & 1 deletion websites/confetti/vite.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,6 @@ export default defineConfig({
],
build: {
outDir: 'dist',
minify: true,
minify: false,
},
});
2 changes: 1 addition & 1 deletion websites/ribbons/vite.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,6 @@ export default defineConfig({
],
build: {
outDir: 'dist',
minify: true,
minify: false,
},
});
75 changes: 62 additions & 13 deletions websites/website/docs/de/guide/bundles-all.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,42 @@
# Bundle: All

`@tsparticles/all` laedt alle offiziellen Features und ist ideal fuer schnelles Prototyping.
`@tsparticles/all` lädt **alles** aus dem tsParticles-Repository: jede Form, Interaktion, Aktualisierer, Effekt, Pfad, Easing, Plugin und Export. Es ist das größte Bundle, gedacht für Prototyping und Demos.

## Wann All waehlen
## Enthaltene Funktionen

- Du willst sofort alle Features verfuegbar haben.
- Du testest Optionen schnell.
- Bundle-Groesse ist weniger wichtig als Setup-Geschwindigkeit.
Erbt alles von `tsparticles` (full) plus:

**Alle Formen:** Pfeil, Karten, Zahnrad, Herz, Unendlichkeit, Matrix, Pfad, Ribbon, abgerundetes Polygon, abgerundetes Rechteck, Spirale, Squircle

**Alle externen Interaktionen:** Kanone, Licht, Partikel, Pop, Partikel-Abstoßen

**Alle Effekte:** Blase, Filter, Partikel, Schatten, Spur

**Alle Pfadgeneratoren:** Äste, Brownsch, Curl-Noise, Kurven, Fraktal-Noise, Gitter, Levy, Perlin-Noise, Polygon, Zufall, Simplex-Noise, Spirale, SVG, Zickzack

**Alle Easings:** Back, Bounce, Circ, Cubic, Elastic, Expo, Gaussian, Linear, Quad, Quart, Quint, Sigmoid, Sine, Smoothstep

**Alle Farb-Plugins:** HEX, HSL, RGB, HSV, HWB, LAB, LCH, Named, OKLAB, OKLCH

**Alle Plugins:** Absorber, Hintergrundmaske, Canvas-Maske, Emitter (alle Formen), Easings (alle), Export-Bild, Export-JSON, Export-Video, Infektion, Manuelle Partikel, Bewegung, Poisson-Scheibe, Polygon-Maske, Responsive, Töne, Themes, Spur, Zoom

**Alle Aktualisierer:** Zerstören, Farbverlauf, Lebenszyklus, Opazität, Orbit, Aus-Modi, Farbe, Rollen, Drehen, Größe, Neigen, Funkeln, Wackeln

## Wann verwenden

- Schnelles Prototyping, um Möglichkeiten zu erkunden
- Demos und Vorführungen
- Entwicklungsumgebungen, in denen die Größe keine Rolle spielt
- **Nicht für die Produktion empfohlen** — bevorzuge gezieltere Bundles

## Installation

### npm/pnpm/yarn

```bash
pnpm add @tsparticles/engine @tsparticles/all
```

## Setup-Beispiel

```ts
import { tsParticles } from "@tsparticles/engine";
import { loadAll } from "@tsparticles/all";
Expand All @@ -25,20 +46,48 @@ await loadAll(tsParticles);
await tsParticles.load({
id: "tsparticles",
options: {
background: { color: "#000" },
particles: {
number: { value: 100 },
shape: { type: "heart" },
move: { enable: true, speed: 2 },
},
},
});
```

## Haeufige Stolperfallen
### CDN (Script-Tags)

```html
<script src="https://cdn.jsdelivr.net/npm/@tsparticles/engine@4/tsparticles.engine.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/@tsparticles/all@4/tsparticles.all.bundle.min.js"></script>
<script>
(async () => {
await loadAll(tsParticles);

await tsParticles.load({
id: "tsparticles",
options: {
particles: {
number: { value: 100 },
move: { enable: true, speed: 2 },
},
},
});
})();
</script>
```

## Unterschied zwischen `tsparticles` und `@tsparticles/all`

Siehe die Vergleichstabelle auf der [Bundles-Full-Seite](/de/guide/bundles-full) für die detaillierte Aufschlüsselung.

## Häufige Fehler

- In Produktion nutzen, obwohl ein kleineres Bundle besser waere.
- `tsParticles.load(...)` vor `loadAll(...)` aufrufen.
- Verwendung in der Produktion — bevorzuge `@tsparticles/slim` oder `tsparticles` für kleinere Bundles.
- `tsParticles.load()` vor `loadAll(tsParticles)` aufrufen.

## Verwandte Seiten
## Siehe auch

- Ueberblick: [`/guide/bundles`](/de/guide/bundles)
- Installationsmatrix: [`/guide/installation`](/de/guide/installation)
- [Bundle-Übersicht](/de/guide/bundles)
- [Installationsanleitung](/de/guide/installation)
81 changes: 67 additions & 14 deletions websites/website/docs/de/guide/bundles-basic.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,46 @@
# Bundle: Basic

`@tsparticles/basic` ist fuer extra-leichte Setups mit minimaler Laufzeit gedacht.
`@tsparticles/basic` ist das leichteste Bundle. Enthält nur das Nötigste: Kreise, die sich mit animierbarer Opazität und Größe bewegen.

## Wann Basic waehlen
## Enthaltene Funktionen

- Bundle-Groesse hat oberste Prioritaet.
- Du brauchst nur grundlegende Effekte.
- Erweiterte Plugins sind nicht erforderlich.
**Formen:** Kreis

**Aktualisierer:**

- Farbe
- Opazität
- Aus-Modi (Verhalten beim Verlassen des Bildschirms)
- Größe

**Plugins:**

- Bewegung
- Mischung (Farbmischung)
- HEX-, HSL-, RGB-Farb-Plugins

**Nicht enthalten:**

- Maus-/Touch-Interaktionen
- Partikelverbindungen
- Andere Formen (Quadrate, Sterne, Bilder, Polygone etc.)
- Emitter, Absorber, Töne
- Drehung, Lebenszyklus, Rollen, Neigen, Wackeln

## Wann verwenden

- Die Bundle-Größe hat oberste Priorität
- Du brauchst nur sich bewegende Punkte
- Keine Interaktionen oder komplexen Formen nötig

## Installation

### npm/pnpm/yarn

```bash
pnpm add @tsparticles/engine @tsparticles/basic
```

## Setup-Beispiel

```ts
import { tsParticles } from "@tsparticles/engine";
import { loadBasic } from "@tsparticles/basic";
Expand All @@ -25,20 +50,48 @@ await loadBasic(tsParticles);
await tsParticles.load({
id: "tsparticles",
options: {
background: { color: "#ffffff" },
particles: {
number: { value: 50 },
move: { enable: true, speed: 1.5 },
color: { value: ["#5bc0eb", "#fde74c", "#9bc53d"] },
size: {
value: { min: 300, max: 400 },
animation: { enable: true, speed: 100 },
},
move: { enable: true, speed: 10 },
},
},
});
```

## Haeufige Stolperfallen
### CDN (Script-Tags)

```html
<script src="https://cdn.jsdelivr.net/npm/@tsparticles/engine@4/tsparticles.engine.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/@tsparticles/basic@4/tsparticles.basic.bundle.min.js"></script>
<script>
(async () => {
await loadBasic(tsParticles);
await tsParticles.load({
id: "tsparticles",
options: {
particles: {
number: { value: 50 },
move: { enable: true, speed: 1.5 },
},
},
});
})();
</script>
```

## Häufige Fehler

- Features erwarten, die nur in nicht enthaltenen Plugins stecken.
- `tsParticles.load(...)` vor `loadBasic(...)` aufrufen.
- Funktionen erwarten, die nicht enthalten sind (z.B. `links`, Maus-Interaktionen) — diese erfordern umfangreichere Bundles.
- `tsParticles.load()` vor `loadBasic(tsParticles)` aufrufen — Formen und Aktualisierer sind noch nicht registriert.
- Nur `@tsparticles/engine` ohne ein Bundle installieren — die Engine allein zeichnet nichts.

## Verwandte Seiten
## Siehe auch

- Ueberblick: [`/guide/bundles`](/de/guide/bundles)
- Installationsmatrix: [`/guide/installation`](/de/guide/installation)
- [Bundle-Übersicht](/de/guide/bundles)
- [Installationsanleitung](/de/guide/installation)
73 changes: 57 additions & 16 deletions websites/website/docs/de/guide/bundles-confetti.md
Original file line number Diff line number Diff line change
@@ -1,42 +1,83 @@
# Bundle: Confetti

`@tsparticles/confetti` bietet eine fokussierte API fuer Konfetti-Effekte mit minimalem Setup.
`@tsparticles/confetti` bietet eine vereinfachte API zum Erstellen von Konfetti-Effekten mit einem einzigen Funktionsaufruf. Keine direkte Interaktion mit `tsParticles` nötig.

## Wann Confetti waehlen
## Enthaltene Funktionen

- Du willst Feier-Effekte mit einem Aufruf.
- Du willst die Engine nicht manuell verdrahten.
- Du bevorzugst eine kompakte API fuer UI-Events.
**Formen:** Kreis, Herz, Karten (französische Farben: Herz, Karo, Kreuz, Pik), Emoji, Bilder, Polygon, Quadrat, Stern

**Interne Plugins:** Emitter, Bewegung (respektiert die Benutzereinstellung zur reduzierten Bewegung)

**Aktualisierer:** Lebenszyklus, Rollen, Drehen, Neigen, Wackeln

**API:** `confetti(options)` oder `confetti(canvasId, options)`

## Wann verwenden

- "Glückwunsch!"- oder "Alles Gute zum Geburtstag!"-Button
- Schneller Feiereffekt
- Du möchtest die Engine nicht manuell konfigurieren

## Installation

### npm/pnpm/yarn

```bash
pnpm add @tsparticles/confetti
```

## Setup-Beispiel

```ts
import { confetti } from "@tsparticles/confetti";

// Basiseffekt
await confetti({
count: 80,
spread: 60,
particleCount: 100,
spread: 70,
origin: { x: 0.5, y: 0.5 },
});

await confetti("canvas-id", {
count: 50,
// Auf einer bestimmten Canvas
await confetti("my-canvas-id", {
particleCount: 50,
angle: 90,
spread: 45,
colors: ["#ff0000", "#00ff00", "#0000ff"],
});
```

## Haeufige Stolperfallen
### CDN (Script-Tag)

```html
<script src="https://cdn.jsdelivr.net/npm/@tsparticles/confetti@4/tsparticles.confetti.bundle.min.js"></script>
<script>
confetti({
particleCount: 100,
spread: 70,
colors: ["#bb0000", "#ffffff"],
});
</script>
```

### Hauptparameter

| Parameter | Typ | Standard | Beschreibung |
| --------------- | -------- | ------------ | ---------------------------------------------------- |
| `particleCount` | number | 50 | Anzahl der Konfettiteilchen |
| `spread` | number | 60 | Streuwinkel (Grad) |
| `angle` | number | 90 | Richtung (Grad, 90 = nach unten) |
| `startVelocity` | number | 30 | Anfangsgeschwindigkeit |
| `colors` | string[] | — | Konfettifarben |
| `origin` | { x, y } | { 0.5, 0.5 } | Ursprungspunkt (0-1) |
| `drift` | number | 0 | Horizontale Drift |
| `shapes` | string[] | — | Formen: "circle", "heart", "square", "star", "cards" |

## Häufige Fehler

- Annehmen, dass `tsParticles` aus `@tsparticles/confetti` exportiert wird.
- Denken, dass `tsParticles` von `@tsparticles/confetti` exportiert wird — das ist nicht der Fall.
- Dieselbe Canvas-ID unbeabsichtigt wiederverwenden.
- `confetti` in einer Schleife aufrufen, ohne die Leistung zu verwalten — verwende ein angemessenes Intervall oder stoppe die Animation, wenn sie fertig ist.

## Verwandte Seiten
## Siehe auch

- Ueberblick: [`/guide/bundles`](/de/guide/bundles)
- Bundle-Playground: [`/playground/bundles`](/de/playground/bundles)
- [Bundle-Übersicht](/de/guide/bundles)
- [Feuerwerk-Bundle](/de/guide/bundles-fireworks)
Loading
Loading