Video → Página de Aterrizaje con Desplazamiento Cinemático
Crea una página de aterrizaje cinematográfica donde el héroe es un video que avanza al desplazarte en lugar de por tiempo, como las páginas de productos de Apple o la página de aterrizaje de GitHub Copilot. Los fotogramas se extraen del video fuente y se intercambian según el usuario se desplaza; debajo del héroe fijo, las secciones de desplazamiento normal contienen el texto y la llamada a la acción.
Cuándo invocar
- El usuario comparte un video y pide una página de aterrizaje, sitio con desplazamiento, héroe con avance por fotogramas o sitio web a partir de un video
- Menciones de "desplazamiento estilo Apple", "página de aterrizaje de GitHub Copilot", "avance al desplazarse", "fotograma al desplazarse"
- Equivalentes en hebreo: "דף נחיתה מסרטון", "אתר עם גלילה", "סרטון בגלילה"
Ubicación de guardado
Por defecto: ~/Documents/yuv-projects/landings/<slug>/ — guarda siempre las páginas de aterrizaje aquí para poder encontrarlas después. Crea el directorio principal si no existe.
mkdir -p ~/Documents/yuv-projects/landings
cd ~/Documents/yuv-projects/landings
# Construye <slug>/ aquí.
Ruta final: ~/Documents/yuv-projects/landings/<slug>/. Informa al usuario dónde se encuentra la página al final de cada construcción.
Flujo de trabajo (8 pasos)
- Analizar el origen —
ffprobepara duración, fps, dimensiones, audio. - Elegir número de fotogramas — por defecto
80. Mínimo40(entre cortado si es menor), máximo160(página pesada). Elige según duración: ≤10s → 50, 10–30s → 80, 30–60s → 120, >60s → 160. - Decidir directorio de salida — por defecto
~/Documents/yuv-projects/landings/<slug>/. El<slug>es corto, derivado del nombre del video o del tema. Sobrescribir solo si se solicita explícitamente. - Extraer fotogramas — ejecuta
references/extract-frames.py <video-origen> <directorio-salida> [cantidad]. Generadirectorio-salida/frames/f_0001.jpg… con calidad JPG constante 82 y un ancho máximo de 1920 (redimensionado si el origen es mayor). - Copiar y personalizar
references/landing-template.htmlendirectorio-salida/index.html:- Reemplaza el marcador
__FRAMES__con etiquetas<img>para cada fotograma (el script de construcción lo hace automáticamente al pasar--build-html). - Rellena
__HEADLINE__,__TAGLINE__,__CTA_TEXT__,__CTA_HREF__, secciones. - Para contenido en hebreo: establece
<html lang="he" dir="rtl">y cambia las fuentes a Rubik/Assistant (consultareferences/design-notes.md).
- Reemplaza el marcador
- Optimizar fotogramas — el script de construcción ya escala a un ancho máximo de 1920px. Si el peso total de la página supera los 12 MB, reduce la calidad a 75 o disminuye el número de fotogramas.
- Previsualizar —
python -m http.serverdentro del directorio de salida y abrehttp://localhost:8000. El desplazamiento se siente suave en una máquina decente. - Desplegar — suelta la carpeta en Vercel/Netlify/Cloudflare Pages. No se necesita paso de construcción.
El mecanismo de desplazamiento
- El contenedor exterior
.scroll-stagetiene una altura en unidades de viewport (por defecto600vh= desplazar 5 pantallas para recorrer todos los fotogramas). - Héroe fijo
position: sticky; top: 0; height: 100vhque contiene todos los fotogramas posicionados absolutamente y ocultos excepto el activo. - El listener de desplazamiento calcula
progress = scrolledIntoStage / scrollableHeightlimitado entre 0 y 1. idx = floor(progress * (N - 1))— intercambia la clase.activea ese fotograma.- Envuelve el listener en
requestAnimationFramepara mantener 60 fps.
Reglas de diseño
- Si el proyecto tiene la marca YUV.AI (Yuval personalmente, su portafolio, su marca): llama a
yuv-design-systemy bloquéalo a un modo según el medio:- Modo Neon (POR DEFECTO para la web de YUV.AI): rosa intenso (
#FF1464) + cian neón (#00E5FF) + blanco o lienzo negro intenso. Anton + Inter (inglés) / Rubik + Assistant (hebreo). Radios 0px o 999px. - Modo Editorial Cálido: solo para Hope, Marcus, bigcats.ai, practical.yuv.ai — rosa + amarillo + hueso, blanco roto nunca
#fffpuro. - Nunca uses el modo Decks (púrpura/amarillo Fly High) para una página de aterrizaje — esa paleta está reservada solo para presentaciones.
- Modo Neon (POR DEFECTO para la web de YUV.AI): rosa intenso (
- Si el proyecto no tiene la marca YUV.AI: no apliques yuv-design-system. Elige una paleta que se adapte al estado de ánimo del video fuente. Anton + Inter siguen siendo valores predeterminados razonables pero no obligatorios.
- Las superposiciones del héroe deben ser sutiles — una viñeta y un solo titular grande; no ahogues el fotograma.
- Secciones debajo del héroe: lienzo claro (blanco en modo Neon, blanco roto en modo Editorial Cálido, hueso si va genérico-cálido), titular grande en Anton, texto del cuerpo en Inter a 18–22px, CTA como una píldora afilada (
border-radius: 999px) — relleno rosa en modo Neon, color apropiado a la marca en otro caso. - Para hebreo: respeta RTL, usa Rubik 900 para titulares, Assistant 400/500 para el cuerpo.
Referencias de archivos
| Archivo | Propósito |
|---|---|
references/extract-frames.py | Extractor de fotogramas basado en ffmpeg; opcionalmente construye el HTML completo de una sola vez |
references/landing-template.html | Esqueleto de página de aterrizaje autónomo con el mecanismo de desplazamiento |
references/design-notes.md | Tipografía, paleta y valores predeterminados de movimiento |