Communitygithub.com

flutter-demo-reel

Transforma um app Flutter em um vídeo promocional ou demo reel em loop para redes sociais (16:9 e 9:16, 60 fps). Cria um app macOS separado dentro de <app>/demo com camada 3D no flutter_scene (Flutter GPU), kit de partículas 2D e títulos, cortes sincronizados com trilha sonora e exportação offline para H.264 e ProRes com ffmpeg. Use quando o usuário solicitar um vídeo promocional, demo reel, trailer, teaser, vídeo de lançamento, vídeo para redes sociais ou showcase animado de um app Flutter.

O que é flutter-demo-reel?

Este skill gera um vídeo promocional em loop (demo reel) para um app Flutter existente, criando um app macOS separado dentro da pasta `demo/` do projeto original. Ele utiliza flutter_scene (Flutter GPU sobre Metal) para camadas 3D, um kit de partículas 2D e títulos para sobreposições, e sincroniza cortes com a batida da música. O fluxo de trabalho inclui entrevista com o usuário para definir duração, formato, trilha sonora e mensagem; estudo do app para capturar telas reais, fontes e cores; análise de áudio para extrair batidas e seções; escrita de um script com tabela de planos; scaffolding do app demo; construção e renderização quadro a quadro; exportação final com supersampling 2x e motion blur de 4 amostras, gerando arquivos H.264 e ProRes. O skill suporta Claude Code (usa variáveis de ambiente como CLAUDE_SKILL_DIR), mas o app gerado é executável em qualquer macOS com Flutter e ffmpeg. A principal vantagem é que cada frame é uma função pura do tempo `t`, permitindo scrub, exportação em blocos, motion blur e loop contínuo sem estado entre frames.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/vlidholt/flutter-skills/tree/HEAD/skills/flutter-demo-reel

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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 adiciona demo/** às exclusões do analisador do pacote pai.
  • Cada frame é uma função pura de t. Sem estado entre frames, sem Random(), 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:

  1. 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.
  2. Trilha sonora: um arquivo (com letra?) ou nenhum, e quem detém os direitos.
  3. 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?).
  4. Aparência e tom: quão exagerado, a marca do app, referências.
  5. Telas reais: quais, e você pode executar o app para capturá-las (conta de teste, dados semeados)? Também cenas atmosféricas inventadas?
  6. Texto na tela: apenas palavras-chave (padrão) ou legendas completas, grafia do nome do produto, palavras a evitar.
  7. 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>/demo com flutter 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/, cria art/, art/screens/, audio/ e fonts/, e ignora out/;
  • 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, kBeatPhase e Cues.
  • lib/core/format.dart: Palette a partir do tema do app e Fonts (copie os arquivos de fonte para demo/fonts/ e declare-os em pubspec.yaml).
  • Assets: art/ (liste subpastas em pubspec.yaml) e audio/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:

  1. 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).
  2. 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.
  3. 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.

Habilidades Relacionadas