Página de destino do Glyph
Um sujeito → uma página. O sujeito faz um loop (um clipe do Kling fixado para que seu último quadro seja o primeiro); o shader o desenha como glifos sobre um fundo animado. Na página:
- Hero: o cursor X divide foto ← | → glifos; o cursor Y define o tamanho da grade; um anel e uma mira seguem o cursor. O título — uma palavra dividida em duas — é desenhado pelo shader como o inverso de um fundo desfocado. Arte linear densa, parte dela rastreando o sujeito.
- Seções: manifesto (um fato verdadeiro com uma reviravolta), marquee, quatro especificações, um CTA final sobre o sujeito novamente. A rolagem dissolve a grade em pixels grandes e vice-versa.
- Série: várias páginas compartilham um motor e um trocador de páginas; cada página obtém sua própria paleta, efeito de fundo, renderizador de glifos, fontes, arte linear e texto.
assets/examples/pages/ contém cinco páginas completas que mostram o escopo (astronauta em um céu noturno, uma papoula em papel, o
Mac de 1984 como planta baixa, uma nuvem com meio-tom e isóbaras, água-viva em braille de neon). Leia uma ou duas antes de escrever uma
página; nunca copie uma integralmente — cada página é desenhada do zero para seu sujeito.
O que você precisa
| Necessidade | Porquê | Como |
|---|---|---|
| Um sujeito | a imagem do usuário, ou uma descrição para gerar uma | pergunte, ou aceite o que eles deram |
FAL_KEY | imagens estáticas, edições e vídeo | variável de ambiente em cada comando (FAL_KEY=… node …); nunca a exiba ou escreva em um arquivo rastreado. Apenas se o usuário pedir para armazenar: um .env.local ignorado pelo git |
| Node 18+, ffmpeg, Python 3 | gerador, empacotamento, máscaras | node -v, ffmpeg -version, python3 -V; macOS brew install node ffmpeg python |
Custo: imagens estáticas são baratas (~$0.15); cada clipe do Kling de 15 s custa visivelmente mais e geralmente precisa de uma repetição — verifique os preços do fal e informe antes do primeiro vídeo.
Passo 0 — Acordar a intenção (uma mensagem curta, depois decidir)
- O sujeito. Imagem própria → verifique-a (marcas d'água: não as remova — peça uma cópia licenciada ou gere um original; uma foto de uma pessoa real → confirme que é ela ou que tem consentimento; produtos com marca registrada são aceitáveis editorialmente, sem logotipos). Sem imagem → você vai gerar uma; proponha um sujeito adequado ao objetivo do usuário.
- A aparência. Se o usuário descreveu uma, siga-a. Caso contrário, escolha você mesmo todas as sete decisões em
references/looks.mde diga o que escolheu em uma ou duas frases. Se o projeto já tiver páginas, faça a nova diferir de cada página existente em pelo menos cinco das sete. - Movimento. O que deve se mover e o quanto ("muito movimento" vs "flutuação calma"); 15 s por padrão.
- Texto e enquadramento. Tom, quaisquer fatos ou nomes que o usuário queira; caso contrário, uma exposição / publicação / evento fictício construídos em torno do sujeito (
references/copy.md).
Passo 1 — Andaime
python3 <skill>/scripts/new_project.py <project-dir> <id> --name "Nome" --title "Primeira/segunda" [--image caminho]
cd <project-dir>/tools && npm install
A primeira chamada cria o projeto (site/ com engine.js, base.css, pages.json, index.html; tools/ com o pipeline; .gitignore). Cada chamada posterior adiciona uma página (site/<id>.html) e a registra em pages.json para que o trocador de cada página a mostre.
Passo 2 — Prompts → imagem estática → revisão
Escreva tools/subjects/<id>.json (references/pipeline.md tem a lista de verificação; assets/examples/subjects/ as cinco que funcionaram). Padrão: um fundo plano preto puro, o sujeito à direita do centro com espaço vazio à esquerda.
FAL_KEY=… node generate.mjs <id> still # a partir do prompt "image"
FAL_KEY=… node generate.mjs <id> edit # ou: a imagem do usuário em um fundo plano (original mantido)
Mostre tools/<id>.png. Itere até o usuário ficar satisfeito — tudo a jusante herda isso.
Passo 3 — Clipe → verificação → revisão
FAL_KEY=… node generate.mjs <id> video # alguns minutos; execute em segundo plano
node generate.mjs <id> check # números de movimento + tools/<id>-sheet.png
Leia os números: abaixo de ~3 no meio significa que mal se move — fortaleça a redação e regenere antes de construir. Mostre a folha de contato. Se o usuário quiser movimento diferente, mostre a ele o prompt revisado antes de gastar novamente.
Passo 4 — Construir o loop empacotado
cd <project-dir> && tools/build_media.sh tools/<id>.png <id> video tools/<id>-motion.mp4
python3 tools/track_blobs.py <id> 3 # opcional: caminhos de partes brilhantes / de alto contraste para sobreposições de rastreamento
Verifique um quadro de site/media/<id>-loop.mp4: a metade direita deve ser uma silhueta branca limpa. Em seguida, meça as posições que você anotará (references/pipeline.md → medindo).
Passo 5 — Projetar a página
Edite site/<id>.html (cada marcador EDIT), usando references/looks.md para decisões,
references/shader-recipes.md para o GLSL e references/copy.md para o texto:
- Tokens
:roote o link do Google Fonts. - O shader:
field()(efeito de fundo + halo),scene()(renderizador de glifos, placa, cor da tinta),photo(),main()(franjas, inversão do título, finalização). Definastage({ focus, cell, zoom, atlas }). - Palavras do título, tamanhos e posicionamento; frases espalhadas; o logotipo/nome da série.
- Trabalho de linha: SVG/DOM denso construído no script, animado; elementos de rastreamento em
onFrameviatoScreen(). - Seções: manifesto, marquee, especificações, CTA, rodapé — com estilo de seção que pertence a esta aparência.
- Telefones: verifique o bloco
@media (max-width:760px)(tamanho do título, tamanho do CTA, ocultar rótulos apertados).
Passo 6 — Visualizar e verificar
cd <project-dir> && python3 -m http.server 5180 -d site # abra http://localhost:5180/<arquivo>
Verifique em um navegador, não lendo o código: o console está limpo; o canvas aparece; mover o cursor divide e redimensiona; o título é legível nos lados da foto e dos glifos; sobreposições ficam sobre o sujeito; role por cada seção;
um desktop largo, uma janela quase quadrada e um telefone de 375 px sem rolagem horizontal. Recarregue forçadamente após edições
(o servidor estático armazena em cache). references/troubleshooting.md cobre o que já deu errado antes.
Passo 7 — Entregar
Informe ao usuário o que você construiu (sujeito, movimento, as sete decisões de aparência, o texto), qualquer coisa que não pôde fazer funcionar e os ajustes que eles provavelmente irão modificar — constantes de franja, opacidade da placa, intervalo da grade, forças dos blobs, tamanho do título — com onde cada um vive. Deixe os clipes brutos do Kling fora do git (.gitignore já faz isso).
Adicionar outra página
Execute new_project.py <project-dir> <new-id> --name … novamente, depois Passos 2–6 para essa página, escolhendo uma aparência que difira das páginas existentes.