# Introducción

Efectos con GPU para tu HTML. Conserva tu contenido y añade efectos a sus bordes.

domfx añade efectos con GPU al borde de la forma visible de un elemento del DOM. El texto sigue siendo seleccionable, los botones conservan sus controladores de eventos y los enlaces siguen funcionando. El efecto se dibuja en un canvas separado junto al contenido original.

> domfx es experimental. La versión `0.1.0-alpha.2` está disponible en npm. Comienza con la [guía de instalación](/docs/es/installation/).

## Comienza con tu elemento

[Sección titulada «Comienza con tu elemento»](#comienza-con-tu-elemento)

El **elemento objetivo** es el texto, botón, imagen o tarjeta cuya forma recibe el efecto. El **contenedor del efecto** (`host`) contiene ese elemento y el canvas decorativo; usa `position: relative` en su CSS. domfx conserva el contenido original.

Sigue [instalación](/docs/es/installation/) y [uso independiente](/docs/es/standalone/) para crear una aplicación completa: un botón con llamas y un contador de clics.

## Comienza con GSAP

[Sección titulada «Comienza con GSAP»](#comienza-con-gsap)

Si ya usas GSAP, sigue la [guía completa de GSAP](/docs/es/gsap/): aplica un efecto al mismo botón, anímalo con tu propia línea de tiempo, avanza o retrocede y libera los recursos. Primero [instala la versión alfa](/docs/es/installation/).

## Controla la animación

[Sección titulada «Controla la animación»](#controla-la-animación)

* [Uso independiente](/docs/es/standalone/): usa animación automática o controla el tiempo del efecto con tu código.
* [GSAP](/docs/es/gsap/): anima un efecto con tu propia línea de tiempo. Anima el tiempo y la intensidad junto con el resto de tu secuencia.

## Elige un efecto

[Sección titulada «Elige un efecto»](#elige-un-efecto)

Elige entre Electricity, Frost, Fire, Slime, Burned paper, Kinetic bloom y los efectos de patrón de la [galería de efectos](/es/effects/). Cada función devuelve una instancia (`EffectHandle`) con controles de tiempo, intensidad, actualización de captura y liberación de recursos. Consulta los [efectos disponibles](/docs/es/api/#available-effects) para ver el nombre de cada importación.

La [guía de uso independiente](/docs/es/standalone/#attach-fire) usa Fire en su ejemplo interactivo. Sus controles de intensidad y reproducción se aplican a todos los efectos.

## Mantén utilizable el contenido original

[Sección titulada «Mantén utilizable el contenido original»](#mantén-utilizable-el-contenido-original)

El efecto es una decoración opcional. Si falta WebGPU, se solicita movimiento reducido o la captura no es compatible, el DOM original sigue disponible. Consulta el estado y el código del motivo, y libera el efecto cuando desaparezca la página o el componente.

Consulta la [referencia de la API](/docs/es/api/) para conocer el contrato público, la [compatibilidad con navegadores](/docs/es/support/) para los límites medidos y [solución de problemas](/docs/es/troubleshooting/) si el efecto no se muestra.
