Referencia de opciones

Las opciones de tsParticles son profundas, asi que esta pagina funciona como mapa practico antes de entrar en cada subopcion.

Elige tu ruta de configuracion

Resultado visual rapido: comienza con un preset y sobrescribe los campos clave.
Control total: define manualmente particles, interactivity y background.
Enfoque config-first: empieza con @tsparticles/configs y ajusta de forma gradual.

Docs rapidas (locales)

Paginas de detalle para particulas

Donde esta la documentacion de referencia

Docs principales de opciones: tsparticles/markdown/Options.md
Paginas detalladas de opciones: tsparticles/markdown/Options/
Interfaces de tipos: tsparticles/engine/src/Options/Interfaces

Opciones raiz mas usadas

background
fullScreen
interactivity
particles
detectRetina
preset
responsive

Secciones mas usadas

background: base para el fondo de canvas y el enmascarado.
particles.number: cantidad y densidad.
particles.move: velocidad, direccion y out modes.
particles.shape: circulo, poligono, imagen, emoji, personalizado.
particles.palette: cambia rapidamente paletas coordinadas.
interactivity: modos hover/click y efectos externos.
detectRetina: equilibrio calidad/rendimiento en pantallas de alta densidad.

Mapa de particulas (vista anidada)

Usa este arbol como ayuda de navegacion antes de abrir paginas de detalle:

text

particles
|- number
|- color
|- shape
|- size
|- opacity
|- move
|- links
|- collisions
|- life
|- destroy
|- group
|- orbit
|- repulse
|- roll
|- rotate
|- shadow
|- stroke
|- tilt
|- twinkle
|- wobble
|- zIndex
`- palette

Primero abre la documentacion raiz y despues los apartados de profundidad:

Raiz: Particles
En detalle: Particles Number, Particles Move, Particles Links

Workflow seguro para opciones

Empieza con una configuracion funcional desde demos o presets.
Cambia una seccion cada vez.
Valida con TypeScript (IOptions) dentro del codigo de la app.
Guarda las opciones de produccion en archivos JSON dedicados.

Ejemplo tipado minimo

import type { ISourceOptions } from "@tsparticles/engine";

export const particlesOptions: ISourceOptions = {
  fpsLimit: 60,
  particles: {
    number: { value: 70 },
    move: { enable: true, speed: 1.5 },
  },
};

Guardrails de rendimiento

Prefiere @tsparticles/slim salvo que necesites plugins avanzados.
Mantén el numero de particulas proporcional al area del contenedor.
Perfila en dispositivos reales antes de anadir interacciones pesadas.

Referencias relacionadas

Docs del paquete de configs: https://github.com/tsparticles/tsparticles/blob/main/utils/configs/README.md
Carpeta de presets: https://github.com/tsparticles/tsparticles/tree/main/presets
Carpeta de paletas: https://github.com/tsparticles/tsparticles/tree/main/palettes

Para el detalle completo de cada subopcion, usa tambien las paginas fuente en tsparticles/markdown/Options enlazadas arriba.

Referencia de opciones ​

Elige tu ruta de configuracion ​

Docs rapidas (locales) ​

Paginas de detalle para particulas ​

Donde esta la documentacion de referencia ​

Opciones raiz mas usadas ​

Secciones mas usadas ​

Mapa de particulas (vista anidada) ​

Workflow seguro para opciones ​

Ejemplo tipado minimo ​

Guardrails de rendimiento ​

Referencias relacionadas ​