Ir al contenido

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.

Si ya tienes una aplicación:

Ventana de terminal
pnpm add -E @domfx/browser@0.1.0-alpha.2

Core 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.

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: false
strictPeerDependencies: true

Ejecuta 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.

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.

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:

Ventana de terminal
pnpm add -E gsap@3.15.0

Si necesitas las funciones opcionales:

Ventana de terminal
pnpm add -E @domfx/gsap@0.1.0-alpha.2

Tu aplicación aporta GSAP; @domfx/browser no lo instala.

Instala la skill de domfx desde el directorio de tu aplicación:

Ventana de terminal
pnpm dlx skills add G0m1namm/domfx --skill domfx

Elige 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.