Página de aterrizaje Glyph
Un sujeto → una página. El sujeto se repite en bucle (un clip de Kling fijado para que su último fotograma sea el primero); el sombreador lo dibuja como glifos sobre un fondo animado. En la página:
- Hero: El cursor X divide foto ← | → glifos; el cursor Y define el tamaño de la cuadrícula; un anillo y una mira siguen al cursor. El título — una palabra dividida en dos — es dibujado por el sombreador como la inversa de un fondo desenfocado. Arte lineal denso, parte de él siguiendo al sujeto.
- Secciones: manifiesto (un dato real con un giro), marquesina, cuatro especificaciones, un CTA de cierre sobre el sujeto nuevamente. El desplazamiento disuelve la cuadrícula en píxeles grandes y viceversa.
- Serie: varias páginas comparten un motor y un cambiador de páginas; cada página tiene su propia paleta, efecto de fondo, renderizador de glifos, fuentes, arte lineal y texto.
assets/examples/pages/ contiene cinco páginas completas que muestran el rango (astronauta en un cielo nocturno, una amapola sobre papel, la
Mac de 1984 como plano, una nube con medio tono e isobaras, medusas en braille neón). Lee una o dos antes de escribir una
página; nunca copies una por completo — cada página está diseñada desde cero para su sujeto.
Lo que necesitas
| Necesidad | Por qué | Cómo |
|---|---|---|
| Un sujeto | la imagen del usuario, o una descripción para generar una | pregunta, o toma lo que te dieron |
FAL_KEY | fotogramas, ediciones y video | variable de entorno en cada comando (FAL_KEY=… node …); nunca la hagas eco ni la escribas en un archivo rastreado. Solo si el usuario pide guardarla: un .env.local ignorado por git |
| Node 18+, ffmpeg, Python 3 | generador, empaquetado, máscaras | node -v, ffmpeg -version, python3 -V; macOS brew install node ffmpeg python |
Costo: los fotogramas son económicos (~$0.15); cada clip de Kling de 15 s cuesta notablemente más y a menudo necesita un reintento — consulta los precios de fal y dilo antes del primer video.
Paso 0 — Acordar la intención (un mensaje corto, luego decidir)
- El sujeto. Imagen propia → verifícala (marcas de agua: no las elimines — pide una copia con licencia o genera una original en su lugar; una foto de una persona real → confirma que es ella o que tiene consentimiento; los productos con marca registrada están bien editorialmente, sin logotipos). Sin imagen → generarás una; propón un sujeto que se adapte al objetivo del usuario.
- El aspecto. Si el usuario describió uno, síguelo. De lo contrario, elige tú mismo las siete decisiones en
references/looks.mdy di lo que elegiste en una o dos frases. Si el proyecto ya tiene páginas, haz que la nueva difiera de cada página existente en al menos cinco de las siete. - Movimiento. Qué debe moverse y cuánto ("mucho movimiento" vs "flotación tranquila"); 15 s por defecto.
- Texto y encuadre. Tono, datos o nombres que el usuario quiera; de lo contrario, una exposición / publicación / evento ficticio
basado en el sujeto (
references/copy.md).
Paso 1 — Andamio
python3 <skill>/scripts/new_project.py <project-dir> <id> --name "Nombre" --title "Primero/segundo" [--image ruta]
cd <project-dir>/tools && npm install
La primera llamada crea el proyecto (site/ con engine.js, base.css, pages.json, index.html; tools/ con
el pipeline; .gitignore). Cada llamada posterior agrega una página (site/<id>.html) y la registra en pages.json para que todas las páginas
muestren su cambiador.
Paso 2 — Prompts → fotograma → revisión
Escribe tools/subjects/<id>.json (references/pipeline.md tiene la lista de verificación; assets/examples/subjects/ las cinco que
funcionaron). Valora por defecto un fondo plano negro puro, el sujeto a la derecha del centro con espacio vacío a la izquierda.
FAL_KEY=… node generate.mjs <id> still # desde el prompt "image"
FAL_KEY=… node generate.mjs <id> edit # o: la imagen del usuario sobre un fondo plano (original conservado)
Muestra tools/<id>.png. Itera hasta que el usuario esté satisfecho — todo lo posterior lo hereda.
Paso 3 — Clip → verificar → revisar
FAL_KEY=… node generate.mjs <id> video # unos minutos; ejecútalo en segundo plano
node generate.mjs <id> check # números de movimiento + tools/<id>-sheet.png
Lee los números: por debajo de ~3 en el medio significa que apenas se mueve — refuerza el texto y regenera antes de construir. Muestra la hoja de contactos. Si el usuario quiere otro movimiento, muéstrale el prompt revisado antes de gastar nuevamente.
Paso 4 — Construir el bucle empaquetado
cd <project-dir> && tools/build_media.sh tools/<id>.png <id> video tools/<id>-motion.mp4
python3 tools/track_blobs.py <id> 3 # opcional: rutas de partes brillantes / de alto contraste para superposiciones de seguimiento
Verifica un fotograma de site/media/<id>-loop.mp4: la mitad derecha debe ser una silueta blanca limpia. Luego mide
las posiciones que anotarás (references/pipeline.md → medición).
Paso 5 — Diseñar la página
Edita site/<id>.html (cada marcador EDIT), usando references/looks.md para las decisiones,
references/shader-recipes.md para el GLSL, y references/copy.md para el texto:
- Tokens
:rooty el enlace de Google Fonts. - El sombreador:
field()(efecto de fondo + halo),scene()(renderizador de glifos, placa, color de tinta),photo(),main()(bordeado, inversión del título, acabado). Configurastage({ focus, cell, zoom, atlas }). - Palabras del título, tamaños y ubicación; frases expandidas; el logotipo/nombre de la serie.
- Trabajo lineal: SVG/DOM denso construido en script, animado; elementos de seguimiento en
onFramemediantetoScreen(). - Secciones: manifiesto, marquesina, especificaciones, CTA, pie de página — con estilo de sección que pertenece a este aspecto.
- Móviles: verifica el bloque
@media (max-width:760px)(tamaño del título, tamaño del CTA, ocultar etiquetas concurridas).
Paso 6 — Vista previa y verificación
cd <project-dir> && python3 -m http.server 5180 -d site # abre http://localhost:5180/<archivo>
Verifica en un navegador, no leyendo código: la consola está limpia; aparece el lienzo; mover el cursor divide y
redimensiona; el título es legible en los lados de la foto y los glifos; las superposiciones están sobre el sujeto; desplázate por cada sección;
un escritorio amplio, una ventana casi cuadrada y un teléfono de 375 px sin desplazamiento horizontal. Recarga forzada después de ediciones
(el servidor estático almacena en caché). references/troubleshooting.md cubre lo que ha salido mal antes.
Paso 7 — Entrega
Dile al usuario lo que construiste (sujeto, movimiento, las siete decisiones de aspecto, el texto), cualquier cosa que no pudiste hacer funcionar,
y los controles que probablemente ajustará — constantes de bordeado, opacidad de la placa, rango de cuadrícula, fuerzas de las manchas, tamaño del título —
con dónde vive cada uno. Deja los clips Kling sin procesar fuera de git (.gitignore ya lo hace).
Agregar otra página
Ejecuta new_project.py <project-dir> <new-id> --name … nuevamente, luego Pasos 2–6 para esa página, eligiendo un aspecto que
difiera de las páginas existentes.