Flutter demo reel
Crie um pequeno vídeo promocional em loop para um app Flutter como seu próprio app Flutter macOS em
<flutter app>/demo, renderize-o offline quadro a quadro e codifique-o. O reel
usa as telas reais do app, arte, fontes e conteúdo, uma camada 3D no
flutter_scene (Flutter GPU no Metal), um kit de partículas 2D e títulos, e cortes
na música.
Os caminhos abaixo são relativos à pasta deste skill (a pasta que contém este
SKILL.md). No Claude Code, essa pasta é ${CLAUDE_SKILL_DIR}.
Regras básicas
- Nunca modifique o app. Copie o que precisar (arte, fontes, capturas de tela,
dados de conteúdo, cores do tema) para
demo/. O scaffold apenas adicionademo/**às exclusões do analisador do pacote pai. - Cada frame é uma função pura de
t. Sem estado entre frames, semRandom(), sem relógios, sem simulação: movimento de forma fechada, aleatoriedade com semente. Isso é o que torna possível o scrub, a exportação em blocos, o motion blur e um loop contínuo. Leia references/kit.md antes de escrever os planos. - Siga as regras de voz do projeto (AGENTS.md, CLAUDE.md ou similar): palavras que o app nunca usa, como o produto se nomeia, tom.
- Combine antes de construir. Entreviste o usuário, depois escreva um roteiro que ele aprove.
- Apenas macOS. Precisa de Flutter com desktop macOS, ffmpeg (
brew install ffmpeg) e Python 3 com Pillow (folhas de contato) e numpy (análise de áudio).
Fluxo de trabalho
1. Entrevista
Pergunte antes de começar, oferecendo um padrão para cada item para que o usuário possa responder rápido:
- Duração e loop (padrão 30 s, loop contínuo), formatos (paisagem 1920x1080 e retrato 1080x1920, retrato projetado para Reels, TikTok e Shorts), 60 fps.
- Trilha sonora: um arquivo (com letra?) ou nenhum, e quem detém os direitos.
- A mensagem: as 3–5 coisas a mostrar, a chamada para ação (URL, badges da loja), alegações a fazer (gratuito? avaliações? contagens?).
- Aparência e tom: quão exagerado, a marca do app, referências.
- Telas reais: quais, e você pode executar o app para capturá-las (conta de teste, dados semeados)? Também cenas atmosféricas inventadas?
- Texto na tela: apenas palavras-chave (padrão) ou legendas completas, grafia do nome do produto, palavras a evitar.
- Algo especial: easter eggs, personagens, coisas que nunca devem ser mostradas.
2. Estude o app
Leia o tema do app (cores, fontes), assets (logos, personagens, ícones), conteúdo (nomes reais, números, dados a mostrar) e suas principais telas. Anote o que o torna distintivo. Planeje as capturas de tela e capture-as, ou peça ao usuário por elas (veja "Capturas de tela reais" em references/craft.md).
3. Analise a trilha sonora
python3 scripts/analyze_audio.py <track>
Converta seu tempo, fase da batida, seções e linhas vocais em cues nomeadas, como em references/audio-sync.md. Sem trilha sonora, ainda escolha um tempo e corte em sua grade.
4. Escreva o roteiro
Faça uma tabela cronometrada com, para cada plano: a música ou letra, a imagem paisagem, a imagem retrato e o texto na tela (modelo em references/craft.md). Marque o gancho, a queda, o cartão final e a costura do loop. Obtenha a aprovação do usuário e itere até ele dizer ok.
5. Scaffold
zsh scripts/scaffold.sh <diretório do app Flutter>
Execute com o caminho completo para a pasta scripts/ deste skill; funciona a partir de
qualquer diretório. Ele:
- cria
<app>/democomflutter create --platforms macos; - adiciona flutter_scene, vector_math e audioplayers, e executa
flutter_scene:init; - habilita Flutter GPU (
FLTEnableFlutterGPU) e desativa o sandbox do app (o exportador executa ffmpeg); - copia o kit inicial de
assets/template/, criaart/,art/screens/,audio/efonts/, e ignoraout/; - exclui
demo/**do analisador do pacote pai.
Funciona dentro de workspaces pub (o demo permanece um pacote independente) e se recusa a sobrescrever uma pasta existente.
Em seguida, configure:
lib/core/timeline.dart:kDuration,kBpm,kBeatPhaseeCues.lib/core/format.dart:Palettea partir do tema do app eFonts(copie os arquivos de fonte parademo/fonts/e declare-os empubspec.yaml).- Assets:
art/(liste subpastas empubspec.yaml) eaudio/track.wav(48 kHz PCM).
Compile uma vez e renderize os stills do exemplo para provar que a configuração funciona:
cd <app>/demo && flutter build macos --profile && tool/run.sh stills "0.3,2.3,9" both
6. Construa o reel
Substitua lib/shots/example.dart por uma seção para cada parte do roteiro, liste-os
em Director.sections e defina os hits da câmera em Director._hits. Trabalhe
seção por seção:
- Escreva a seção (frame 3D e camadas 2D abaixo e acima dele) usando o kit (references/kit.md) e flutter_scene (references/flutter-scene.md).
- Execute
flutter build macos --profile, depois renderize stills nos momentos-chave da seção em ambos os formatos:tool/run.sh stills "t1,t2,..." both. - Faça uma folha de contato por formato e inspecione-a, além de stills individuais
de perto onde o detalhe importa:
python3 tool/sheet.py out/l.png 4 480 out/stills/landscape_*.png. Se não puder visualizar imagens, diga ao usuário quais stills verificar e o que procurar. Corrija e repita.
Execute a lista de verificação de revisão em references/craft.md sobre todo o
reel antes de exportar. O usuário pode assisti-lo com a música no app de
visualização (open build/macos/Build/Products/Profile/*.app); stills não podem
mostrar o timing.
7. Exportar
tool/export.sh draft both # 1x, sem motion blur: uma verificação rápida completa
tool/export.sh final both # supersampling 2x, motion blur de 4 amostras
Uma exportação final leva aproximadamente 10–15 minutos por formato para 30 s. Execute-a em
segundo plano se seu ambiente permitir, e não a verifique repetidamente. Depois,
verifique os arquivos com ffprobe: a contagem de frames é kDuration * kFps, a
duração está correta e há um stream de áudio. Extraia alguns frames dos
MP4s, incluindo o último frame e o frame 0 (a costura do loop).
8. Entregue e itere
Dê ao usuário os caminhos (demo/out/final/<format>.mp4 para upload,
<format>_master.mov ProRes para edição), os tamanhos dos arquivos e o que
verificar. Espere comentários. Os típicos, com correções, estão em
references/craft.md: texto mantido por muito pouco tempo, texto
coberto, legendas indesejadas, costuras em contornos, raios de luz fortes, um conjunto de itens
que parecem iguais, redação no retrato. Corrija todos os comentários em uma rodada antes de
renderizar novamente.
Arquivos
- references/kit.md: a arquitetura e APIs do kit inicial.
- references/flutter-scene.md: configuração do flutter_scene, aparência e problemas off-line.
- references/audio-sync.md: tempo, fase, letras e cues de uma faixa.
- references/craft.md: modelo de roteiro, regras de texto, receitas de efeitos, capturas de tela, lista de verificação de revisão.
scripts/scaffold.sh: cria o app demo.scripts/analyze_audio.py: tempo, fase da batida, loudness por compasso, onsets.assets/template/: o kit inicial que o scaffold copia.