Instalación
Instala la versión alfa experimental desde npm.
Usa Node 22.22.3, pnpm 11.5.0 y un navegador con WebGPU.
Esta guía crea una pequeña aplicación con Vite y la versión experimental
0.1.0-alpha.2. La API puede cambiar.
Instala la versión alfa
Sección titulada «Instala la versión alfa»Si ya tienes una aplicación:
pnpm add -E @domfx/browser@0.1.0-alpha.2Core se instala automáticamente. GSAP es opcional. Usa la misma versión de todos los
paquetes @domfx, fija versiones exactas y conserva el archivo de bloqueo de
dependencias; la API es experimental aunque la etiqueta
latest de npm apunte a ella.
Crea tu aplicación de prueba
Sección titulada «Crea tu aplicación de prueba»Para una aplicación nueva, ejecuta mkdir my-domfx-preview y después
cd my-domfx-preview. Guarda esto como package.json:
{ "name": "my-domfx-preview", "private": true, "type": "module", "scripts": { "dev": "vite --host 127.0.0.1", "build": "vite build", "preview": "vite preview --host 127.0.0.1" }, "dependencies": { "@domfx/browser": "0.1.0-alpha.2" }, "devDependencies": { "typescript": "5.9.3", "vite": "7.3.7" }}Guarda esto como pnpm-workspace.yaml:
autoInstallPeers: falsestrictPeerDependencies: trueEjecuta pnpm install --ignore-scripts. Importa las exportaciones públicas de los
paquetes compilados; no necesitas alias de código fuente, copiar shaders ni un plugin TypeGPU.
Proporciona el objetivo y el contenedor
Sección titulada «Proporciona el objetivo y el contenedor»Crea index.html:
<!doctype html><html lang="es"> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width" /> <link rel="icon" href="data:," /> <title>Vista previa de domfx</title> <style> body { background: #14151B; color: #E8EAF3; font-family: sans-serif; } #host { position: relative; padding: 3rem; width: fit-content; } #target { min-width: 10rem; min-height: 3rem; font: inherit; } </style> <div id="host"><button id="target">Contenido original</button></div> <p>Clics: <output id="clicks">0</output></p> <script type="module" src="/main.ts"></script></html>El elemento objetivo (target) es el botón cuya forma recibe el efecto.
El contenedor del efecto (host) contiene el objetivo y el canvas decorativo.
Usa elementos distintos en el mismo documento, con position: relative en el
contenedor y espacio para las llamas. Mantén ambos en el documento durante el efecto.
Continúa con uso independiente para crear
main.ts y ver el resultado. Si ya usas GSAP, sigue la guía de GSAP.
En React o Vue, copia las recetas probadas.
Añade el enlace opcional de GSAP
Sección titulada «Añade el enlace opcional de GSAP»Para animar propiedades de forma nativa, añade solo gsap a tu aplicación.
El paquete @domfx/gsap solo hace falta para las funciones opcionales que conservan los valores iniciales
y gestionan el ciclo de vida.
Para seguir la guía de GSAP:
pnpm add -E gsap@3.15.0Si necesitas las funciones opcionales:
pnpm add -E @domfx/gsap@0.1.0-alpha.2Tu aplicación aporta GSAP; @domfx/browser no lo instala.
Configura tu agente de programación
Sección titulada «Configura tu agente de programación»Instala la skill de domfx desde el directorio de tu aplicación:
pnpm dlx skills add G0m1namm/domfx --skill domfxElige tu agente de programación y la instalación en el proyecto cuando se te
pregunte. Conserva --skill domfx para seleccionar solo la guía de uso, sin las
skills de ingeniería del repositorio. Se instalan instrucciones, no la biblioteca npm.
La skill ayuda a tu agente a elegir efectos, animarlos y liberar recursos. Puedes pedirlo en español o inglés, por ejemplo: «Añade Fire a este botón y libera sus recursos cuando se desmonte el componente». Las instrucciones se mantienen en inglés; las explicaciones y los comentarios siguen tu idioma. La detección de la skill depende del agente; reinicia su sesión si hace falta. El instalador admite varios agentes, pero no se han probado todos con domfx.