Página de Aterrissagem em Parallax
Transforme um vídeo curto em uma landing page cinematográfica de tela única, onde o scroll do usuário percorre o vídeo quadro a quadro enquanto cinco cenas de texto dramáticas fazem crossfade de entrada e saída. O documento nunca rola de verdade — a entrada de roda/toque/teclado é interceptada em JavaScript e convertida em progresso virtual de quadro.
Esta skill codifica os padrões comprovados no pacote de referência em ../../examples/parasites/ (as landings github / lion / hope — três páginas funcionais construídas com esta mesma skill). Trate essa pasta como a verdade absoluta se algo aqui for ambíguo.
Onde esta skill se encaixa na pirâmide do YUV.AI
parallax-landing-page está no nível intermediário da pirâmide de skills do YUV.AI, ao lado de yuv-design-system, yuv-decks, yuv-viral-video e video-to-landing-page. O orquestrador de nível superior yuv-pilot roteia para cá sempre que um clipe de vídeo de 5 a 15 segundos precisa se tornar uma landing page de herói único com scroll-scrub.
Esta skill traz sua própria linguagem visual (Anton + Caveat + Inter, paleta dourado/âmbar/destaque/creme) — ela NÃO chama yuv-design-system. Os dois sistemas coexistem: yuv-design-system possui a paleta da marca em superfícies web/app/deck, parallax-landing-page possui a estética cinematográfica de scroll-scrub especificamente. Para landings parallax do YUV.AI, você pode OPCIONALMENTE adicionar uma marca d'água da fênix + o URL canônico do Linktree no rodapé como um fio condutor da marca — veja yuv-design-system/assets/ para o arquivo da marca d'água. NÃO substitua a pilha de tipos Anton/Caveat pela paleta Neon do design system — isso perderia a aparência característica.
O que você está construindo
Cada landing é um viewport fixo único com:
- Um canvas preenchendo a tela, desenhando um quadro por vez (cover-fit, DPR ≤ 2)
- 5 cenas de texto posicionadas absolutamente (kicker + título Anton maiúsculo + linha manuscrita Caveat), cada uma com sua própria janela de progresso de scroll
- Uma navegação fixa com logotipo
PARALLAX // showcasee links para landings irmãs - Um loader que pré-carrega todos os quadros antes de permitir a interação do usuário
- Uma vinheta + sobreposição de granulação de filme
- Uma dica de scroll inferior que desaparece quando o usuário começa a rolar
- Um contador de quadros no canto inferior direito (ex.:
073 / 145) - Uma cena final que é a seção de CTA — nenhuma seção
.endseparada abaixo
Peso total em q:v 2: aproximadamente 120–220 KB por quadro × número de quadros. Um clipe de 6 segundos a 24fps = 145 quadros ≈ 25 MB. Um clipe de 10 segundos = 241 quadros ≈ 53 MB.
Local de salvamento
Padrão: ~/Documents/yuv-projects/landings/<slug>/ — sempre salve landings autônomas aqui para que você possa encontrá-las novamente. Substitua apenas se o usuário escolher explicitamente um local diferente OU se o Modo B (integrar ao showcase examples/parasites/ existente) for selecionado.
mkdir -p ~/Documents/yuv-projects/landings
cd ~/Documents/yuv-projects/landings
# A skill cria <slug>/ aqui enquanto extrai os quadros e constrói o HTML.
Caminho final (Modo A — autônomo): ~/Documents/yuv-projects/landings/<slug>/.
Caminho final (Modo B — integração): o diretório do showcase existente que o usuário escolheu.
Informe ao usuário o caminho final ao final de cada construção.
Fluxo de trabalho
Há quatro fases. Não pule fases — cada uma alimenta a próxima.
Fase 1 — Descobrir
Confirme com o usuário:
- Caminho do vídeo — onde o MP4 de origem está.
- Slug — nome curto de pasta/arquivo (ex.:
hope,marcus,desk). Uma palavra, minúscula, sem espaços. Isso se torna tanto o nome da pasta de quadros (<slug>/) quanto o nome do arquivo HTML (<slug>.html). - Tema / assunto — sobre o que é esta landing? Um lançamento de produto? Um momento pessoal? Um encontro com a vida selvagem? Você precisa disso para escrever o texto.
- Modo do projeto — autônomo (pasta nova) ou integrar ao showcase de parasitas existente em
examples/parasites/(topo deste repositório). Se o usuário disser "adicione ao showcase", ele quer o Modo B abaixo. - Cor de destaque — para o script/realce do CTA:
gold(#f5b042),amber(#ff8a3d),accent(rosa #ff4d6d),cream(#f5e9d4), ou algo novo (adicione a:rootem style.css e escreva uma nova regra.script.<nome>).
Se o usuário não especificou alguns destes, proponha padrões e siga em frente — não pare em perguntas que eles podem responder quando virem o resultado.
Fase 2 — Extrair quadros
Execute o script de extração incluído. Ele sonda o vídeo com ffprobe e extrai todos os quadros na resolução nativa com -q:v 2 (JPEG quase sem perdas), nomeando-os frame-001.jpg até frame-NNN.jpg (com padding de 3 dígitos).
python <skill>/scripts/extract_frames.py <video_path> <output_folder>
Exemplo:
python C:/Users/User/.claude/skills/parallax-landing-page/scripts/extract_frames.py \
C:/Users/User/Documents/parasites/hope/hope.mp4 \
C:/Users/User/Documents/parasites/hope
O script imprime um bloco JSON de metadados em stdout. Capture-o — você precisa de frame_count e suggested_scroll_budget para o HTML.
Por que -q:v 2: ezgif e ferramentas similares re-comprimem agressivamente (~55 KB/quadro). O ffmpeg nativo em q:v 2 dá ~120–220 KB/quadro nas mesmas dimensões — visivelmente mais nítido. Não reduza a escala; nunca aumente a escala (isso infla os arquivos sem adicionar detalhes).
Por que a fórmula do orçamento de scroll (≈26 px por quadro): mantém o tátil "pixels de scroll por quadro avançado" constante em todos os comprimentos de clipe. 145 quadros → ~4200, 241 quadros → ~6300, 90 quadros → ~2500 (piso). O script calcula isso para você e fixa em [2500, 8000].
Fase 3 — Criar a página
Leia o template em <skill>/assets/landing-page-template.html. É um arquivo funcional completo com marcadores {{PLACEHOLDER}} e comentários <!-- TODO: --> ao lado das partes criativas. Escreva um novo arquivo em <target>/<slug>.html com tudo substituído.
Lista de verificação de substituição (todo marcador deve ser substituído):
| Placeholder | O que colocar | Exemplo |
|---|---|---|
{{PAGE_TITLE}} | Título HTML <title> | Hope — O Coração Mais Rápido do Neguev |
{{PAGE_DESCRIPTION}} | meta description, uma frase | Um momento com Hope, a chita do Midbarium. |
{{SLUG}} | nome da pasta (sem caminho, sem barra) | hope |
{{FRAME_COUNT}} | número inteiro de quadros | 241 |
{{FRAME_COUNTER_TEXT}} | 001 / NNN com largura correspondente | 001 / 241 |
{{SCROLL_BUDGET}} | inteiro do JSON do extrator | 6300 |
{{PREVIEW_FRAME_MID}} | quadro intermediário com padding | 121 |
{{PREVIEW_FRAME_END}} | último quadro com padding | 241 |
{{LOADER_TITLE}} | uma palavra, maiúscula | HOPE |
{{LOADER_SCRIPT}} | linha manuscrita terminando em … | convocando o corredor… |
{{NAV_LINKS_HTML}} | bloco completo de tags <a> para navegação | veja abaixo |
{{SCENE_N_*}} | kicker, título, linha manuscrita para cada uma das 5 cenas | veja guia de texto |
{{SCROLL_HINT_TEXT}} | prompt maiúsculo de 2 a 4 palavras | SCROLL PARA CORRER |
{{CTA_BUTTONS_HTML}} | 2 a 4 tags <a class="cta"> | veja abaixo |
{{ACCENT_CLASS}} | sufixo de cor de destaque para .script.X e .cta.X | amber |
Leia references/copy-guide.md para os padrões de texto cinematográfico (formulação do kicker, tamanho do título, tom da linha manuscrita). O texto é onde esta skill ganha seu valor — um texto genérico afundará uma animação que de outra forma seria bonita.
Fase 4 — Conectar ativos
Se a pasta de destino já possui style.css e parallax.js (integração com showcase), não faça nada — eles são compartilhados. Caso contrário, copie ambos de <skill>/assets/ para a pasta de destino:
cp <skill>/assets/style.css <target>/style.css
cp <skill>/assets/parallax.js <target>/parallax.js
Se estiver integrando a um showcase existente, também siga os passos em references/showcase-integration.md — adicione um card ao index.html, adicione um link a todas as barras de navegação de landings existentes e adicione o CTA em cadeia na cena final da landing anterior.
Informe ao usuário como visualizar:
Abra
<target>/<slug>.htmlviapython -m http.server 8000a partir da pasta pai (nãofile://— o Chromium pode contaminar o canvas com origens de imagem locais).
Contrato de arquivos
<target>/
├── <slug>/ # pasta de quadros
│ ├── <slug>.mp4 # a fonte (preservada)
│ ├── frame-001.jpg
│ ├── frame-002.jpg
│ └── … frame-NNN.jpg
├── <slug>.html # a página de aterrissagem
├── style.css # compartilhado (copiar se autônomo)
├── parallax.js # compartilhado (copiar se autônomo)
└── index.html # o hub (apenas se autônomo ou integração)
O nome da pasta de quadros e o nome do arquivo HTML DEVEM compartilhar o mesmo slug — a opção folder na chamada new ParallaxPage({folder: '<slug>', ...}) da página é o caminho literal da pasta.
A API ParallaxPage (já está em parallax.js, não redefinir)
new ParallaxPage({
folder: '<slug>', // pasta contendo frame-001.jpg, etc.
frameCount: 145, // inteiro
prefix: 'frame-', // sempre 'frame-' para esta skill
scrollBudget: 4200, // pixels de entrada acumulada para passagem completa
// opcional: padWidth (padrão 3), ext (padrão 'jpg')
})
A classe anexa automaticamente body.scrub-page (que trava o scroll via CSS), pré-carrega todos os quadros, executa um lerp orientado por RAF (fator 0.22) em direção ao quadro alvo derivado do scroll e faz crossfade nas cenas cujos intervalos data-start/data-end incluem o progresso atual.
Restrições rígidas (os itens inegociáveis)
Elas estão incorporadas na referência e quebram a experiência se violadas:
- 5 cenas, janelas de progresso fixas:
0.00–0.20,0.22–0.40,0.42–0.60,0.62–0.80,0.82–1.00. A lacuna de 0.02 entre as cenas é intencional — é um momento de "apenas a imagem, sem texto" entre os batimentos. O herói (cena 1) e a final (cena 5) usamdata-fade="0.30"edata-fade="0.18"respectivamente para que segurem mais nas bordas; as cenas do meio usam o padrão de 0.25. - Nenhuma seção
.endabaixo do scrub. A cena final contém os CTAs. A página inteira é um viewport fixo. - Anton + Caveat + Inter — Anton maiúsculo para tudo em negrito, Caveat para acentos manuscritos (dourado/âmbar/creme), Inter para qualquer texto de corpo principal. Nunca substitua, nunca adicione uma quarta fonte.
- Off-white
#f5f1ea, nunca#fff— já está no CSS comovar(--text). - Os nomes dos quadros são
frame-NNN.jpgcom padding até a largura do total (3 dígitos é o padrão, pois clipes < 1000 quadros; o JS calcula automaticamente a largura do contador a partir do total). - O slug é o nome da pasta E a base do nome do arquivo HTML —
hope/,hope.html. Sem exceções; as etapas de integração assumem isso.
Onde consultar quando você ficar preso
- O showcase de referência incluído neste repositório:
examples/parasites/— github.html, lion.html, hope.html, style.css, parallax.js, index.html. Se sua saída divergir visivelmente dessas, você se desviou; releia. references/copy-guide.md— como escrever as 5 cenas para que realmente pareçam cinematográficas.references/showcase-integration.md— edições exatas necessárias ao adicionar a um hub existente.assets/landing-page-template.html— a estrutura canônica com placeholders.assets/hub-template.html— usado apenas ao criar um showcase novo (3 cards do zero).
Dois exemplos reais de invocação
Autônomo: o usuário tem um único clipe desk.mp4 e quer uma landing page.
- Pergunte pelo slug + tema. Execute o extrator em
desk.mp4→./desk/frame-NNN.jpg. - Copie
style.css+parallax.jspara a raiz do projeto. - Crie
desk.htmla partir do template. A navegação tem apenas um link: ela mesma. - Pronto. Informe ao usuário para servir com
python -m http.server.
Adição ao showcase: o usuário adiciona hope.mp4 à pasta de parasitas existente.
- Slug =
hope. Extrair →hope/frame-NNN.jpg. (Reutilizar style.css + parallax.js existentes.) - Criar
hope.htmla partir do template. - Executar integração ao showcase: adicionar um terceiro card ao
index.html, anexar um linkHopeà barra de navegação emgithub.htmlelion.html, encadear a cena final da landing anterior com um CTAPróximo: Hope →. - Se estiver introduzindo uma nova cor de destaque, adicione-a a
:roote adicione regras.script.X+.cta.Xemstyle.css.