Habilidade de Vídeo de Demonstração Remotion
Esta habilidade ajuda a construir e manter a demonstração de vídeo Remotion localizada em:
demos/wallrun-video
Ela fornece estrutura para:
- criação de cenas
- estrutura de composição
- componentes de movimento reutilizáveis
- ritmo do vídeo
- explicações voltadas para desenvolvedores
Esta habilidade deve ser usada ao trabalhar em:
- composições Remotion
- componentes de cena
- segmentos explicativos animados
- estrutura ou sequenciamento de vídeo
- primitivas de movimento usadas pela demonstração
Contexto do projeto
Este repositório é um monorepo Nx.
O vídeo Remotion está localizado em:
demos/wallrun-video
O projeto renderiza um vídeo explicativo voltado para desenvolvedores para WallRun.
O público-alvo são desenvolvedores frontend, não profissionais de marketing.
Presume-se que o espectador entenda:
- React
- TypeScript
- arquitetura de componentes
- sistemas de layout
- ferramentas de desenvolvimento
Evite explicar conceitos básicos de JavaScript.
Intenção de design
O vídeo deve parecer mídia para desenvolvedores, não um anúncio de produto.
Tom apropriado:
- editorial
- minimalista
- moderno
- confiante
- movimento contido
Tom inadequado:
- promoção genérica de SaaS
- efeitos cinematográficos de trailer
- animações pesadas de partículas
- texto denso de marketing
Priorize:
- legibilidade
- hierarquia
- ritmo
- clareza
Estrutura do projeto
Todo o código deve estar dentro de:
demos/wallrun-video/src
Estrutura:
- components/ — Primitivas de apresentação reutilizáveis
- scenes/ — Seções temporizadas do vídeo
- data/ — Roteiro, texto, constantes de tempo
- Root.tsx — Registra composições
- index.ts — Arquivo de entrada para o CLI Remotion
Regras de design de cena
Cada cena deve comunicar apenas uma ideia.
Duração típica: 4 a 8 segundos
As cenas devem:
- ser lidas rapidamente
- ter tipografia grande
- evitar poluição visual
- manter movimento sutil
Tipos de cena preferidos:
- cartões de título
- capturas de tela encenadas do repositório
- closes de componentes
- sobreposições de destaque
- diagramas de arquitetura
- painéis de estatísticas
Evite:
- UI minúscula
- parágrafos longos
- transições excessivamente complexas
Diretrizes de animação
Prefira animação determinística e simples.
Exemplos:
- fade in
- deslizar para cima
- revelação escalonada
- escala sutil
Evite:
- efeitos de bounce
- movimento com física complexa
- curvas de easing pesadas
O objetivo é clareza, não espetáculo.
Convenções de código
Use:
- componentes funcionais React
- TypeScript
- exports nomeados
- tipos explícitos
- wrappers de movimento reutilizáveis
Evite:
- código de animação duplicado
- números mágicos
- tempo de cena codificado
Extraia constantes de tempo quando prático.
Exemplo:
const TITLE_FADE_IN = 20;
const CALLOUT_DELAY = 15;
Fluxo de trabalho padrão para criar uma nova cena
- Defina a mensagem da cena
- Defina a duração em frames
- Bloqueie o layout
- Adicione movimento primário
- Adicione movimento secundário apenas se melhorar a clareza
- Verifique a legibilidade
- Garanta que o código seja reutilizável
Alvos Nx
- preview —
nx preview wallrun-videoabre o Remotion Studio - render —
nx render wallrun-videorenderiza o vídeo completo emdist/demos/wallrun-video/ - type-check —
nx type-check wallrun-videoexecuta o compilador TypeScript
Definição de concluído
Uma cena está concluída quando:
- a mensagem é imediatamente clara
- a tipografia é legível na escala do vídeo
- a animação é contida
- os tempos são fáceis de editar
- o código está estruturado de forma limpa