Sobre o projeto

Reel é uma ferramenta de código aberto para criar demonstrações como código para aplicações web e interfaces de linha de comando. Uma pequena especificação YAML controla a aplicação real — seja em um navegador Chromium via Playwright ou em um terminal real — e registra o que realmente acontece. A filmagem registrada é então renderizada em GIFs sempre atualizados, arquivos MP4, WebM, storyboards em PNG e composições HTML interativas alimentadas pelo HyperFrames. O fluxo de trabalho gira em torno de um arquivo de especificação: escreva ou capture-o, execute `reel check` para verificar se cada etapa ainda funciona, depois `reel shoot` para produzir a filmagem. `reel compose` estrutura um projeto HyperFrames, e os autores preenchem as descrições de cena antes da renderização. Principais funcionalidades: - **Modo de captura**: controle sua aplicação manualmente e deixe o Reel escrever a especificação automaticamente, incluindo seletores estáveis baseados em acessibilidade. - **Gramática de cenas**: cartões de título, chamadas de atenção, destaques, transições, diagramas (Mermaid), zooms, rolagens e gestos de arraste estruturados em sequências direcionadas, em vez de gravações brutas. - **Predefinições de entrega**: saídas otimizadas para READMEs, redes sociais, documentações e compartilhamento de alta fidelidade. - **Áudio**: narração opcional via ElevenLabs ou OpenAI, efeitos sonoros sintetizados, música de fundo com atenuação de voz e sincronização de imagem com a fala. - **Legendas e localização**: arquivos SRT/VTT complementares com variantes traduzidas por LLM por idioma. - **Tratamento de autenticação**: faça login uma vez fora da câmera com uma sessão Playwright salva; as demonstrações são reproduzidas com autenticação sem expor senhas nas especificações. - **Determinismo**: congela relógios, desativa animações, fixa fuso horário e localidade para renderizações reproduzíveis. - **Plugin Claude Code**: construa e refine demonstrações por meio de linguagem natural usando as habilidades `/reel` e `/reel-polish`. - **Interface Studio**: uma interface Next.js local para edição de especificações, gravação com pré-visualização ao vivo, criação com IA e verificação de desvio. - **Integração com CI**: o `reel check` funciona como um teste de fumaça que falha o pipeline quando os fluxos de demonstração quebram. - **Suporte a editores**: preenchimento automático de esquema YAML para VS Code, JetBrains e Neovim. Tudo roda localmente — 100% licenciado sob MIT, sem SaaS, sem necessidade de hospedagem. Requer Node.js 22+ e TypeScript.