Video → Página de Aterrizaje con Scroll Cinemático
Crea una página de aterrizaje cinematográfica donde el héroe es un video que avanza con el scroll en lugar de con el tiempo, como las páginas de productos de Apple o la landing de GitHub Copilot. Los fotogramas se extraen del video de origen y se intercambian a medida que el usuario se desplaza; debajo del héroe sticky, las secciones de desplazamiento normal contienen texto y llamadas a la acción.
Cuándo invocar
- El usuario proporciona un video y pide una página de aterrizaje, sitio con scroll, héroe con scroll de fotogramas o sitio web a partir de un video.
- Menciones como "scroll estilo Apple", "landing de GitHub Copilot", "avance con scroll", "fotograma al hacer scroll".
- Equivalentes en hebreo: "דף נחיתה מסרטון", "אתר עם גלילה", "סרטון בגלילה"
Ubicación de guardado
Predeterminado: ~/Documents/yuv-projects/landings/<slug>/ — guarda siempre las páginas de aterrizaje aquí para poder encontrarlas de nuevo. Crea el directorio padre si no existe.
mkdir -p ~/Documents/yuv-projects/landings
cd ~/Documents/yuv-projects/landings
# Construye <slug>/ aquí.
Ruta final: ~/Documents/yuv-projects/landings/<slug>/. Al final de cada compilación, informa al usuario dónde se encuentra la página.
Flujo de trabajo (8 pasos)
- Analiza la fuente —
ffprobepara duración, fps, dimensiones, audio. - Elige el número de fotogramas — predeterminado
80. Mínimo40(entrecortado si es menor), máximo160(página pesada). Elige según la duración: ≤10s → 50, 10–30s → 80, 30–60s → 120, >60s → 160. - Decide el directorio de salida — predeterminado
~/Documents/yuv-projects/landings/<slug>/. El<slug>es corto, derivado del nombre del video o del tema. Sobrescribe solo si se solicita explícitamente. - Extrae los fotogramas — ejecuta
references/extract-frames.py <video-origen> <directorio-salida> [cantidad]. Generadirectorio-salida/frames/f_0001.jpg… con calidad JPG consistente 82 y un ancho máximo de 1920 (reduce la escala si la fuente es más grande). - Copia y personaliza
references/landing-template.htmlendirectorio-salida/index.html:- Reemplaza el marcador
__FRAMES__con etiquetas<img>para cada fotograma (el script de compilación lo hace automáticamente al pasar--build-html). - Completa
__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
- Optimiza los fotogramas — el script de compilació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.
- Previsualiza —
python -m http.serverdentro del directorio de salida y abrehttp://localhost:8000. El desplazamiento se siente suave en una máquina decente. - Despliega — coloca la carpeta en Vercel/Netlify/Cloudflare Pages. No se necesita paso de compilación.
El mecanismo de scroll
- El contenedor de desplazamiento exterior
.scroll-stagetiene una altura en unidades de viewport (predeterminado600vh= desplazar 5 pantallas para recorrer todos los fotogramas). - Héroe sticky:
position: sticky; top: 0; height: 100vhque contiene todos los fotogramas posicionados de forma absoluta y ocultos excepto el activo. - El listener de scroll calcula
progreso = desplazadoEnElEscenario / alturaDesplazabley lo limita entre 0 y 1. idx = piso(progreso * (N - 1))— intercambia la clase.activea ese fotograma.- Envuelve el listener en
requestAnimationFramepara mantener 60fps.
Reglas de diseño
- Si el proyecto es marca YUV.AI (Yuval personalmente, su portafolio, su marca): invoca
yuv-design-systemy fija un modo según el medio:- Modo Neon (PREDETERMINADO para la web de YUV.AI): rosa intenso (
#FF1464) + cian neón (#00E5FF) + blanco o negro intenso como lienzo. Anton + Inter (inglés) / Rubik + Assistant (hebreo). Radios de 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 de diapositivas.
- Modo Neon (PREDETERMINADO para la web de YUV.AI): rosa intenso (
- Si el proyecto no es de marca YUV.AI: no apliques yuv-design-system. Elige una paleta que se adapte al estado de ánimo del video de origen. Anton + Inter siguen siendo valores predeterminados razonables, pero no obligatorios.
- Las superposiciones del héroe deben ser sutiles: una viñeta y un único titular grande; no ahogues el fotograma.
- Secciones debajo del héroe: lienzo claro (blanco en modo Neon, blanco roto en Editorial Cálido, hueso si es genérico-cálido), titular grande en Anton, texto del cuerpo en Inter a 18–22px, CTA como píldora marcada (
border-radius: 999px) — relleno rosa en modo Neon, color apropiado para la marca en otros casos. - Para hebreo: respeta RTL, usa Rubik 900 para titulares, Assistant 400/500 para 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 scroll |
references/design-notes.md | Tipografía, paleta y valores predeterminados de movimiento |