Remotion — Extensões do Toolkit
Conhecimento central do Remotion está em
.claude/skills/remotion-official/(sincronizado do repositório oficial remotion-dev/skills). Este arquivo cobre apenas padrões específicos do toolkit.
Componentes Compartilhados
Componentes de vídeo reutilizáveis em lib/components/. Importe em modelos via:
import { AnimatedBackground, SlideTransition, Label } from '../../../../lib/components';
| Componente | Propósito |
|---|---|
AnimatedBackground | Fundo com formas flutuantes (variantes: sutil, tech, quente, escuro) |
SlideTransition | Transições de cena (fade, zoom, slide-up, blur-fade) |
Label | Emblema de rótulo flutuante com referência JIRA opcional |
Vignette | Sobreposição de escurecimento de borda cinematográfica |
LogoWatermark | Marca d'água de logotipo no canto |
SplitScreen | Comparação de vídeo lado a lado |
NarratorPiP | Sobreposição de apresentador picture-in-picture |
Envelope | Envelope 3D com animação de aba se abrindo |
PointingHand | Emoji de mão apontando animado com deslizamento e pulsação |
MazeDecoration | Decoração de grade isométrica animada para cantos |
Transições Personalizadas
O toolkit inclui uma biblioteca de transições em lib/transitions/ para efeitos entre cenas além do pacote oficial @remotion/transitions.
Usando TransitionSeries
import { TransitionSeries, linearTiming } from '@remotion/transitions';
// Importe transições personalizadas de lib (ajuste o caminho conforme a localização do seu projeto)
import { glitch, lightLeak, clockWipe, checkerboard } from '../../../../lib/transitions';
// Ou importe de @remotion/transitions para as oficiais
import { slide, fade } from '@remotion/transitions/slide';
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={90}>
<TitleSlide />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={glitch({ intensity: 0.8 })}
timing={linearTiming({ durationInFrames: 30 })}
/>
<TransitionSeries.Sequence durationInFrames={120}>
<ContentSlide />
</TransitionSeries.Sequence>
</TransitionSeries>
Transições Personalizadas Disponíveis
| Transição | Opções | Melhor Para |
|---|---|---|
glitch() | intensity, slices, rgbShift | Demonstrações tech, revelações arrojadas, cyberpunk |
rgbSplit() | direction, displacement | Tech moderno, transições energéticas |
zoomBlur() | direction, blurAmount | CTAs, momentos de alta energia, impacto |
lightLeak() | temperature, direction | Celebrações, estética cinematográfica, momentos calorosos |
clockWipe() | startAngle, direction, segments | Conteúdo relacionado a tempo, revelações lúdicas |
pixelate() | maxBlockSize, gridSize, scanlines, glitchArtifacts, randomness | Retrô/games, transformações digitais |
checkerboard() | gridSize, pattern, stagger, squareAnimation | Revelações lúdicas, transições estruturadas |
Padrões de checkerboard: sequential, random, diagonal, alternating, spiral, rows, columns, center-out, corners-in
Exemplos de Transições
// Sensação tech/cyberpunk
glitch({ intensity: 0.8, slices: 8, rgbShift: true })
// Celebração calorosa
lightLeak({ temperature: 'warm', direction: 'right' })
// Zoom de alta energia
zoomBlur({ direction: 'in', blurAmount: 20 })
// Aberração cromática
rgbSplit({ direction: 'diagonal', displacement: 30 })
// Revelação em varredura de relógio
clockWipe({ direction: 'clockwise', startAngle: 0 })
// Pixelização retrô
pixelate({ maxBlockSize: 50, glitchArtifacts: true })
// Padrões checkerboard
checkerboard({ pattern: 'diagonal', gridSize: 8 })
checkerboard({ pattern: 'spiral', gridSize: 10 })
checkerboard({ pattern: 'center-out', squareAnimation: 'scale' })
Diretrizes de Duração de Transição
| Tipo | Quadros | Notas |
|---|---|---|
| Corte rápido | 15-20 | Rápido, contundente |
| Padrão | 30-45 | Mais comum |
| Dramática | 50-60 | Revelações lentas |
| Efeitos glitch | 20-30 | Deve parecer repentino |
| Light leak | 45-60 | Precisa de tempo para varrer |
Visualizar Transições
Execute a galeria de demonstração para ver todas as transições:
cd showcase/transitions && npm run studio
Melhores Práticas do Toolkit
- Animações baseadas em quadros apenas — Evite transições/animações CSS; elas causam cintilação durante a renderização
- Use fps de useVideoConfig() — Torne as animações independentes da taxa de quadros
- Clampe interpolações — Use
extrapolateRight: 'clamp'para evitar valores fora de controle - Use OffthreadVideo — Melhor desempenho que
<Video>para composições complexas - delayRender para async — Sempre bloqueie a renderização até que os dados estejam prontos
- staticFile para ativos — Faça referência correta a arquivos da pasta
public/ - Todos os projetos usam 30fps — Timing: quadros = segundos × 30
- playbackRate deve ser constante — Para velocidades variáveis/extremas, pré-processe com FFmpeg
Convenções de Timing de Projeto
| Tipo de Cena | Duração | Notas |
|---|---|---|
| Título | 3-5s (90-150f) | Logotipo + manchete |
| Visão geral | 10-20s | 3-5 pontos principais |
| Demonstração | 10-30s | Ajuste playbackRate para encaixar |
| Estatísticas | 8-12s | 3-4 cartões de estatísticas |
| Créditos | 5-10s | Fade rápido |
Ritmo: ~150 palavras/minuto para narração. A narração dita o timing.
API Avançada
Para documentação detalhada da API de todos os hooks, componentes, renderizador, Lambda e Player, veja reference.md.
Nota de Licença
Remotion possui uma licença especial. Empresas podem precisar obter uma licença para uso comercial. Verifique https://remotion.dev/license
Feedback & Contribuições
Se esta skill estiver faltando informações ou puder ser melhorada:
- Faltando um padrão? Descreva o que você precisava
- Encontrou um erro? Informe o que está errado
- Quer contribuir? Posso ajudar você a:
- Atualizar esta skill com melhorias
- Criar um PR para github.com/digitalsamba/claude-code-video-toolkit
Basta dizer "melhore esta skill" e eu guiarei você na atualização de .claude/skills/remotion/SKILL.md.