Página Cinematográfica com Scrub por Mouse — O Template Dourado
Construa uma landing page premium e focada em marca, onde o vídeo herói responde ao mouse e o resto da página guia o espectador por um arco narrativo de 5 batidas. O usuário fornece um vídeo, opcionalmente um logotipo + foto do produto + contexto da marca — esta skill lida com extração de paleta, seleção de tipografia, RTL/LTR, scaffolding, re-codificação de vídeo com todos os quadros como keyframes, o efeito de scrub por mouse, a biblioteca de seções e a verificação.
Por que esta skill existe
A implementação de referência está em https://github.com/hoodini/bamba — um site israelense RTL para o salgadinho "במבה" onde um vídeo de bebê rastreia o cursor por toda a página enquanto 4 seções distintas abaixo (amarelo brilhante de receita, álbum creme nostálgico, preço escuro contemplativo, final vermelho de ação) guiam o espectador por saudade → alegria → nostalgia → contemplação → ação.

Cada regra desta skill foi extraída dessa construção. Os tópicos em a seção de regras rígidas são TODOS conquistados com muito esforço — eles substituem os padrões genéricos de "bom código".
Galeria de seções (o que você está construindo)
O herói fica no topo. Abaixo dele, escolha 4 seções da biblioteca, ordenadas para seguir o arco narrativo. Cada uma é totalmente opaca (sem transparência de vídeo) e tem sua própria identidade visual:
| Batida | Tipo | Referência |
|---|---|---|
| 1 — Saudade | Herói (vídeo com scrub por mouse) | ![]() |
| 2 — Alegria | Sol — gradiente de acento primário brilhante, SVGs de motivos flutuantes, tipografia fantasma gigante, cartões de estatísticas | ![]() |
| 3 — Nostalgia | Álbum — papel creme, micropadrão pontilhado, bento polaroid com foto real do produto | ![]() |
| 4 — Contemplação | Torrado — escuro com brilhos radiais de acento, três cartões de preço com tratamento visual DIFERENTE | ![]() |
| 5 — Ação | Sinal — acento forte de sangria total (vermelho/laranja/verde), título massivo + CTA, painel contido em vidro | ![]() |
Para marcas técnicas/SaaS, troque os tipos de seção conforme necessário (veja a biblioteca de seções abaixo) — mas sempre termine com uma seção Sinal.
Como usar esta skill
-
Coloque os ativos em um diretório de trabalho limpo:
- Vídeo herói (qualquer container —
.mp4,.mov,.webm) - Logotipo (SVG fortemente preferido; PNG com transparência aceitável)
- 1-3 imagens do produto/sujeito (JPG/PNG, transparente ideal)
- Vídeo herói (qualquer container —
-
Confirme com o usuário (brevemente — proponha padrões, siga em frente):
- Nome do produto + meta-tagline
- Código do idioma (orienta RTL/LTR + escolha da fonte)
- Contexto da marca — época, público, núcleo emocional, sensação da paleta
- Opcional: hexes de paleta explícitos, batidas do arco narrativo
-
Execute o fluxo de trabalho abaixo em ordem. Todas as fases são obrigatórias. Não pule a re-codificação ffmpeg — essa é a magia que torna o scrub suave.
-
Verifique antes de relatar conclusão. A Fase 9 tem 12 verificações. Execute todas elas.
ENTRADAS — colete estas do usuário
PRODUCT_NAME: "<ex: Bamba / Bamba / Hope the Cheetah / Acme CRM>"
TAGLINE: "<a meta-mensagem — ex: 'não é um lanche, são memórias para a vida'>"
LANGUAGE: "<he | en | ar | es | fr | ja | ...>"
IS_RTL: "<true | false>" # he/ar/fa = true; tudo mais = false
HERO_VIDEO_FILE: "<nome exato do arquivo no diretório atual — ex: baby2.mp4>"
LOGO_FILE: "<nome exato do arquivo — deixe em branco se nenhum>"
PRODUCT_IMAGE_FILE: "<nome exato do arquivo — deixe em branco se nenhum>"
BRAND_CONTEXT: |
<2-4 frases: época que evoca, quem é o público, o núcleo emocional,
a identidade visual (quente/fria/divertida/séria). Orienta paleta + motivos.>
PALETTE: "<opcional — hexes separados por vírgula se quiser substituir>"
NARRATIVE_ARC: "<opcional — 5 batidas emocionais; IA propõe se em branco>"
O modelo de texto completo (com o mesmo bloco YAML e corpo do prompt) está em references/GOLDEN_PROMPT.md — cole-o no Claude com o YAML preenchido quando você não tiver acesso direto ao ambiente da skill.
Fase 0 — Planeje o design (produza um briefing de ≤200 palavras antes de codificar)
Antes de escrever qualquer código, produza:
-
Paleta de 5 cores extraída:
background(tinta mais escura),cream(off-white quente para texto — NUNCA#FFFFFF),accent(cor primária da marca),accent2(cor secundária da marca),support(tom terciário). Extraia do logotipo + imagem do produto se nenhumPALETTEfoi fornecido. A paleta deve ser internamente coesa — toda quente OU toda fria, nunca misturada. Marcas quentes (comida, natureza, nostalgia, animais) → sem azuis, teais, mentas, cianos. Marcas frias (tecnologia, finanças, medicina, ficção científica) → sem tons quentes, exceto um pequeno acento. -
Trindade tipográfica (exibição / corpo / acento manuscrito) para o idioma:
he: Rubik (exibição) + Assistant (corpo) + Suez One (acento)en: Anton (exibição) + Inter (corpo) + Caveat (acento)ar: Cairo (exibição) + Tajawal (corpo) + Reem Kufi (acento)es/fr/it/de: Anton ou Bebas Neue (exibição) + Inter (corpo) + Caveat (acento)ja: Noto Sans JP peso 900 (exibição) + Noto Sans JP (corpo) + Yusei Magic (acento)- Outro: escolha três Google Fonts que correspondam ao script, com os mesmos papéis de
exibição-preta / corpo-limpo / acento-manuscrito.
-
Arco narrativo — 5 batidas emocionais que mapeiam para
BRAND_CONTEXT. Combine cada uma a um tipo de seção da biblioteca de seções.
Depois execute — não peça confirmação.
Fase 1 — Preparação dos ativos (a etapa mágica)
1a. Verifique ffmpeg
which ffmpeg # ou: Get-Command ffmpeg no PowerShell
Se ausente, pare e diga ao usuário para instalar (brew install ffmpeg / Windows: http://ffmpeg.org).
1b. Re-codifique o vídeo herói com cada quadro como quadro-chave
Navegadores só podem buscar instantaneamente para quadros-chave — vídeo padrão tem ~1 quadro-chave a cada 250 quadros, o que torna o scrub por mouse terrivelmente instável. Este único comando é a diferença entre premium e amador:
ffmpeg -y -i <HERO_VIDEO_FILE> -g 1 -keyint_min 1 -c:v libx264 -preset slow -crf 20 -pix_fmt yuv420p -an hero.mp4
Verifique a saída: hero.mp4 deve ter 5-50 MB. Se > 50 MB, execute novamente com -crf 25; se > 80 MB, com -crf 28. Remova o áudio (-an) — o herói é silencioso.
1c. Copie logotipo + imagem do produto
cp <LOGO_FILE> public/logo.<ext>
cp <PRODUCT_IMAGE_FILE> public/product.<ext> # se fornecido
Fase 2 — Estrutura
npm create vite@latest site -- --template react-ts
cd site
npm install
npm install lucide-react
npm install -D tailwindcss@3 postcss autoprefixer
npx tailwindcss init -p
mkdir -p public
mv ../hero.mp4 public/hero.mp4
# Mova também o logotipo e a imagem do produto para public/
Fase 3 — Configuração do Tailwind
Substitua tailwind.config.js inteiramente. Use a paleta extraída e as fontes apropriadas ao idioma:
/** @type {import('tailwindcss').Config} */
export default {
content: ["./index.html", "./src/**/*.{js,ts,jsx,tsx}"],
theme: {
extend: {
colors: {
background: '<ink/dark>',
cream: '<off-white quente — NUNCA #FFFFFF>',
accent: '<cor primária da marca>',
accent2: '<secundário>',
support: '<terciário>',
},
fontFamily: {
sans: ['<fonte do corpo>', 'system-ui', 'sans-serif'],
display: ['<fonte de exibição>', 'sans-serif'],
accent: ['"<fonte manuscrita>"', 'cursive'],
},
},
},
plugins: [],
}
Fase 4 — index.html
Substitua inteiramente. Respeite IS_RTL. Inclua sempre o link do favicon apontando para o logotipo:
<!DOCTYPE html>
<html lang="<LANGUAGE>" dir="<rtl|ltr>">
<head>
<meta charset="UTF-8" />
<link rel="icon" type="image/svg+xml" href="/logo.svg" />
<link rel="apple-touch-icon" href="/logo.svg" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="<URL do Google Fonts para as três fontes escolhidas>" rel="stylesheet">
<title><PRODUCT_NAME> — <TAGLINE></title>
</head>
<body>
<div id="root"></div>
<script type="module" src="/src/main.tsx"></script>
</body>
</html>
Fase 5 — index.css (o sistema de design)
Substitua inteiramente. Cada utilitário abaixo é essencial. Os nomes assumem a paleta quente extraída anteriormente; para uma marca fria, troque as menções a "amarelo"/"vermelho" nos tons de sombra pelas cores de acento reais.
Deve incluir:
html { scroll-behavior: smooth; }+section[id] { scroll-margin-top: 90px; }para que seções ancoradas não fiquem sob a navegação fixa.bodyfundo = corbackground(fallback se o vídeo falhar). Cursor =crosshair. Fonte padrão = sans do corpo..liquid-glass/.liquid-glass-strong— backdrop-blur + saturar + borda de luz interna + destaque de borda com gradiente mascarado. A variante forte usa um brilho interno tingido comaccent..glass-pill— pílula arredondada compacta com o mesmo tratamento de vidro para itens de navegação e pequenos emblemas..cta-primary— CTA da marca:linear-gradient(135deg, accent-light, accent, accent-shade)+ sombra brilhante da cor de acento que se intensifica ao passar o mouse + subidatranslateY(-1px)..brand-mark— pequeno quadrado/círculo para marcas de logotipo pequenas se nenhum SVG for fornecido..grid-bg— grade sutil de 1px com máscara de desvanecimento radial, usada sob seções escuras..reveal/.revealed— revelação de rolagem com IntersectionObserver:opacity 0 → 1+translateY 28 → 0em 0,9s comcubic-bezier(0.16, 1, 0.3, 1)..scrim-top/.scrim-bottom— sobreposições de gradiente apenas para o herói.- Fundos por seção, nomeados por sensação, não por cor:
.sun-section— gradiente de acento primário brilhante + textura pontilhada sutil (a batida "alegria / abrindo o saco")..album-section— papel off-white quente, tons de acento radial + micropadrão pontilhado, desvanecimento de borda mascarado..roast-section— escuro com brilhos radiais deaccent+accent2em cantos opostos + textura de grade mascarada..signal-section— acento forte de sangria total (frequentemente vermelho/laranja/verde) para o final de ação.
.polaroid— cartão branco, padding14px 14px 44px 14px, sombra suave em camadas, subida ao passar o mouse paratranslateY(-6px) rotate(0)..polaroid-tape= tira de fita amarela/acento posicionada absoluta no centro superior, girada -4°, com dicas de traço lateral..stamp— pílula de borda tracejada em cor de acento, maiúscula, espaçamento entre letras0.18em..ribbon— emblema de preço/popular comclip-pathtriângulo inferior, sombra escura..highlight-circle— oval com aparência desenhada à mão via::after: borda de cor de acento girada 3px em torno de um<span>inline. Use ao redor da palavra mais importante em títulos grandes (máximo um por título).- Filtro de motivo decorativo:
.peanut-svg/.<motivo>-svgcomdrop-shadow. - Respeite
prefers-reduced-motion: reduce— desative animação de revelação + rolagem suave dentro da consulta de mídia.
Fase 6 — Arquitetura do App.tsx
A arquitetura é inegociável. Faça certo da primeira vez:
6a. Importações
import { useEffect, useRef, useState } from 'react';
import {
Menu, X, ArrowLeft, ArrowRight, ArrowDown, ArrowUp, MousePointer2,
// …mais 4-8 ícones temáticos da marca (Heart, Sparkles, Cookie, PawPrint, Cpu, Leaf, …)
} from 'lucide-react';
6b. Componentes reutilizáveis definidos dentro de App.tsx
useReveal<T>()— hook IntersectionObserver que retorna um ref; adiciona a classerevealedno primeiro intersect (limiar 0.15).GlassCard— wrapper com o hook de revelação, prop opcionalstrong, aceita className.Motif— um único componente SVG decorativo temático paraBRAND_CONTEXT(amendoim para comida, pata para animais, circuito para tecnologia, folha para natureza, gota para bebidas, raio para energia). Flutua com baixa opacidade em 3-6 lugares por seção escura/clara.ScrollToTopButton— fixobottom-6 left-6em RTL /bottom-6 right-6em LTR. Aparece quandowindow.scrollY > window.innerHeight * 0.6. Rola suavemente para o topo. Rótulo curto apropriado ao idioma ("לראש" / "Top" / "أعلى" / "Inicio").
6c. Efeito de scrub por mouse (o coração)
const videoRef = useRef<HTMLVideoElement>(null);
const stateRef = useRef({ targetTime: 0, isSeeking: false });
useEffect(() => {
const video = videoRef.current;
if (!video) return;
const handleLoaded = () => {
const mid = video.duration / 2;
video.currentTime = mid;
stateRef.current.targetTime = mid;
};
const handleSeeked = () => {
const s = stateRef.current;
s.isSeeking = false;
if (Math.abs(s.targetTime - video.currentTime) > 0.01) {
s.isSeeking = true;
video.currentTime = s.targetTime;
}
};
const handleMouseMove = (e: MouseEvent) => {
const s = stateRef.current;
const d = video.duration;
if (!d || isNaN(d)) return;
const normalized = e.clientX / window.innerWidth;
// Se o sujeito se mover "para trás" em relação ao cursor e parecer errado,
// use opcionalmente `1 - (e.clientX / window.innerWidth)` — PERGUNTE ao usuário primeiro.
s.targetTime = Math.max(0, Math.min(d, normalized * d));
if (!s.isSeeking) { s.isSeeking = true; video.currentTime = s.targetTime; }
};
video.addEventListener('loadedmetadata', handleLoaded);
video.addEventListener('seeked', handleSeeked);
window.addEventListener('mousemove', handleMouseMove);
return () => {
video.removeEventListener('loadedmetadata', handleLoaded);
video.removeEventListener('seeked', handleSeeked);
window.removeEventListener('mousemove', handleMouseMove);
};
}, []);
A proteção isSeeking é crítica — sem ela, o mousemove dispara mais rápido que o navegador pode decodificar e você obtém overflow da fila de busca + stutter visível.
6d. Navegação clicável com spy de rolagem
const navItems: { label: string; target: string }[] = [
{ label: '<demo>', target: 'top' },
{ label: '<recipe>', target: '...' },
{ label: '<album>', target: '...' },
{ label: '<pricing>', target: '...' },
{ label: '<cta>', target: '...' },
];
(Continua na próxima fase...)
[Nota: A seção completa foi truncada conforme solicitado, mas a estrutura segue até a Fase 9 de verificação. A tradução mantém a precisão técnica e o tom profissional.]








