Remotion — Extensões do Toolkit
Conhecimento central do Remotion reside em
.claude/skills/remotion-official/(sincronizado do repositório oficial remotion-dev/skills). Este arquivo cobre padrões específicos do toolkit apenas.
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 opcional ao JIRA |
Vignette | Sobreposição de escurecimento de bordas 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 entrada 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 de cena a cena 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 ousadas, cyberpunk |
rgbSplit() | direction, displacement | Tech moderna, transições energéticas |
zoomBlur() | direction, blurAmount | CTAs, momentos de alta energia, impacto |
lightLeak() | temperature, direction | Celebrações, estética cinematográfica, momentos quentes |
clockWipe() | startAngle, direction, segments | Conteúdo relacionado a tempo, revelações lúdicas |
pixelate() | maxBlockSize, gridSize, scanlines, glitchArtifacts, randomness | Retro/gaming, transformações digitais |
checkerboard() | gridSize, pattern, stagger, squareAnimation | Revelações lúdicas, transições estruturadas |
Padrões do 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 quente
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 de relógio
clockWipe({ direction: 'clockwise', startAngle: 0 })
// Pixelização retrô
pixelate({ maxBlockSize: 50, glitchArtifacts: true })
// Padrões de tabuleiro
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, impactante |
| Padrão | 30-45 | Mais comum |
| Dramático | 50-60 | Revelações lentas |
| Efeitos glitch | 20-30 | Devem parecer repentinos |
| Vazamento de luz | 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 tremulação durante a renderização
- Use fps de useVideoConfig() — Torne as animações independentes da taxa de quadros
- Interpolações com clamp — Use
extrapolateRight: 'clamp'para evitar valores descontrolados - Use OffthreadVideo — Melhor desempenho do que
<Video>para composições complexas - delayRender para async — Sempre bloqueie a renderização até que os dados estejam prontos
- staticFile para assets — Referencie arquivos da pasta
public/corretamente - Todos os projetos usam 30fps — Temporização: quadros = segundos × 30
- playbackRate deve ser constante — Para velocidades variáveis/extremas, pré-processe com FFmpeg
Convenções de Temporização de Projeto
| Tipo de Cena | Duração | Notas |
|---|---|---|
| Título | 3-5s (90-150q) | Logotipo + título |
| Visão geral | 10-20s | 3-5 marcadores |
| Demonstração | 10-30s | Ajuste playbackRate para caber |
| 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 define o tempo.
API Avançada
Para documentação detalhada da API sobre todos os hooks, componentes, renderizador, Lambda e Player, veja reference.md.
Nota de Licença
Remotion tem uma licença especial. Empresas podem precisar obter uma licença para uso comercial. Verifique https://remotion.dev/license
Feedback e Contribuições
Se esta habilidade estiver faltando informações ou puder ser melhorada:
- Falta um padrão? Descreva o que você precisava
- Encontrou um erro? Informe o que está errado
- Quer contribuir? Posso ajudá-lo a:
- Atualizar esta habilidade com melhorias
- Criar um PR para github.com/digitalsamba/claude-code-video-toolkit
Basta dizer "melhore esta habilidade" e eu o guiarei na atualização de .claude/skills/remotion/SKILL.md.