# Instalación

Instala la versión alfa experimental desde npm.

Usa Node 22.22.3, pnpm 11.5.0 y un [navegador con WebGPU](/docs/es/support/). 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»](#instala-la-versión-alfa)

Si ya tienes una aplicación:

Ventana de terminal

```sh
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.

## Crea tu aplicación de prueba

[Sección titulada «Crea tu aplicación de prueba»](#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`:

```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`:

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

## Proporciona el objetivo y el contenedor

[Sección titulada «Proporciona el objetivo y el contenedor»](#proporciona-el-objetivo-y-el-contenedor)

Crea `index.html`:

```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](/docs/es/standalone/#attach-fire) para crear `main.ts` y ver el resultado. Si ya usas GSAP, sigue la [guía de GSAP](/docs/es/gsap/). En React o Vue, copia las [recetas probadas](/docs/es/frameworks/).

## Añade el enlace opcional de GSAP

[Sección titulada «Añade el enlace opcional de GSAP»](#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:

Ventana de terminal

```sh
pnpm add -E gsap@3.15.0
```

Si necesitas las [funciones opcionales](/docs/es/api/gsap/#snapshot-bindings):

Ventana de terminal

```sh
pnpm add -E @domfx/gsap@0.1.0-alpha.2
```

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

## Configura tu agente de programación

[Sección titulada «Configura tu agente de programación»](#configura-tu-agente-de-programación)

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

Ventana de terminal

```sh
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.
