Quando usar
Carregue este skill sempre que você ler ou escrever código Remotion, desde a criação do projeto até a renderização do vídeo final.
Erros comuns de IA a evitar
Verifique cada alteração de código Remotion contra esses modos de falha recorrentes antes de confirmar:
- Aleatoriedade não determinística — use
random(seed)doremotion, nuncaMath.random(),Date.now()ounew Date(). Caso contrário, renders paralelos produzem ruído tremeluzente. inputPropsnão memorizados no<Player>— sempre passe props memorizadas; props não memorizadas causam tempestades de re-renderização em toda a árvore.- Falta de
delayRender()/continueRender()em torno de trabalho assíncrono (fetch, carregamento de fontes, medição). Sem eles, a renderização trava em 30.000 ms. inputRangenão monotônico nas legendas — oinputRangedointerpolatedeve aumentar estritamente. Para clipes curtos useMath.min(10, Math.floor(duration / 3))para a janela de fade.- Easing linear em todo lugar — prefira
spring()para movimento natural; use linear apenas para necessidades técnicas explícitas. - Importações esquecidas do
@remotion/google-fonts— toda fonte precisa de uma chamada explícitaloadFont({ weights, subsets }). - Saída de composição única monolítica — divida cenas em pequenas composições focadas e componha com
<Sequence>ou<TransitionSeries>. startFrom/endAtobsoletos — usetrimBefore/trimAfterem vez disso.
Configuração de novo projeto
Quando estiver em uma pasta ou workspace vazio sem um projeto Remotion existente, crie um usando:
npx create-video@latest --yes --blank --no-tailwind my-video
Substitua my-video por um nome de projeto adequado.
Iniciando pré-visualização
Inicie o Remotion Studio para pré-visualizar um vídeo:
npx remotion studio
Opcional: verificação de renderização de um frame
Você pode renderizar um único frame com a CLI para verificar layout, cores ou temporização. Pule para edições triviais, refatorações puras ou quando já tiver confiança suficiente do Studio ou de renderizações anteriores.
npx remotion still [composition-id] --scale=0.25 --frame=30
A 30 fps, --frame=30 é a marca de um segundo (--frame é baseado em zero).
Índice de regras
Leia os arquivos de regras individuais para explicações detalhadas e exemplos de código.
Core
- core/compositions.md - Definindo composições, stills, pastas, props padrão e metadados dinâmicos
- core/sequencing.md - Padrões de sequenciamento - atraso, corte, limite de duração de itens
- core/timing.md - Temporização com interpolate, easing Bezier e springs
- core/animations.md - Habilidades fundamentais de animação
- core/trimming.md - Cortar o início ou fim de animações
- core/parameters.md - Tornar um vídeo parametrizável com um esquema Zod
- core/calculate-metadata.md - Definir dinamicamente duração, dimensões e props da composição
- core/primitives.md - Primitivos de layout e temporização: Loop, Freeze, Series, Null, IFrame, AnimatedImage, premount
Media
- media/images.md - Incorporando imagens usando o componente Img
- media/videos.md - Incorporando vídeos - corte, volume, velocidade, loop
- media/gifs.md - Exibindo GIFs sincronizados com a linha do tempo do Remotion
- media/lottie.md - Incorporando animações Lottie
- media/transparent-videos.md - Renderizando um vídeo com transparência
- media/assets.md - Importando imagens, vídeos, áudio e fontes
- media/light-leaks.md - Efeitos de overlay de vazamento de luz
- media/3d.md - Conteúdo 3D usando Three.js e React Three Fiber
Áudio
- audio/audio.md - Usando áudio e som - importação, corte, volume, velocidade, pitch
- audio/voiceover.md - Narração gerada por IA usando ElevenLabs TTS
- audio/audio-visualization.md - Visualizando áudio (barras de espectro, formas de onda, reativo a graves)
- audio/silence-detection.md - Detecção adaptativa de silêncio usando FFmpeg
- audio/sfx.md - Usando efeitos sonoros
- audio/subtitles.md - Visão geral de legendas e subtítulos
- audio/get-audio-duration.md - Obtendo a duração de um arquivo de áudio com Mediabunny
- audio/ai-captions.md - Transcrição por IA: @remotion/openai-whisper, whisper-web, install-whisper-cpp
Texto
- text/text-animations.md - Tipografia e padrões de animação de texto
- text/measuring-text.md - Medindo dimensões de texto, ajustando texto a contêineres
- text/fonts.md - Carregando fontes do Google e fontes locais
- text/google-fonts.md - Pacotes por fonte do @remotion/google-fonts com pesos/subconjuntos necessários
- text/display-captions.md - Renderizando legendas na tela
- text/import-srt-captions.md - Importando arquivos de legenda SRT
Avançado
- advanced/maps.md - Adicionando um mapa usando Mapbox e animando-o
- advanced/charts.md - Gráficos e visualização de dados (barras, pizza, linha, ações)
- advanced/transitions.md - Padrões de transição de cena (básico)
- advanced/transitions-package.md - Referência completa do @remotion/transitions - apresentações, temporização, personalizado
- advanced/tailwind.md - Usando TailwindCSS no Remotion
- advanced/measuring-dom-nodes.md - Medindo dimensões de elementos DOM
- advanced/hdr.md - Espaço de cor e saída HDR: bt709, displayp3, rec2020, ProRes
Utilitários
- utilities/ffmpeg.md - Usando FFmpeg para operações de vídeo
- utilities/can-decode.md - Verificar se um vídeo pode ser decodificado usando Mediabunny
- utilities/extract-frames.md - Extrair frames em timestamps específicos
- utilities/get-video-dimensions.md - Obtendo largura e altura de um arquivo de vídeo
- utilities/get-video-duration.md - Obtendo a duração de um arquivo de vídeo em segundos
- utilities/transcribe-captions.md - Transcrevendo legendas
Produção
- production/delay-render.md - Suspender a renderização durante trabalho assíncrono: delayRender, continueRender, cancelRender
- production/determinism.md - Renderizações determinísticas com random(seed); nunca Math.random / Date.now
- production/rendering.md - @remotion/renderer Node SSR: bundle, selectComposition, renderMedia
- production/cli.md - Subcomandos e flags do npx remotion (render, still, bundle, studio, benchmark)
- production/config.md - Configuradores do remotion.config.ts (codec, CRF, concurrency, Webpack)
- production/lambda.md - AWS Lambda: deployFunction, deploySite, renderMediaOnLambda, ajuste de custo
- production/player.md - @remotion/player: incorporação, PlayerRef, inputProps memorizados, eventos de buffer
- production/video-tag-decision.md - Escolher entre Video / OffthreadVideo / Html5Video / @remotion/media
- production/input-props.md - Ordem de resolução de props, validação Zod, flags CLI --props, segurança de limite de renderização
- production/caption-timing-safety.md - inputRange monotônico e janela de fade adaptativa para legendas
- production/performance.md - Aceleração de hardware, concorrência, formato de imagem, pré-computação GPU, benchmarking
- production/env-vars.md - Prefixo REMOTION_, carregamento .env, segredos via inputProps / envVariables
Integração
- integration/nextjs.md - Next.js App Router: guard SSR do Player, transpilePackages, rota de API para Lambda
- integration/docker.md - Docker: imagem base, --shm-size, fontes, flags Chromium, exemplo CI
- integration/mediabunny-migration.md - Migrar de media-parser/webcodecs obsoleto para Mediabunny Video/Audio
- integration/v5-prep.md - Preparar código v4 para o futuro contra mudanças quebradas do v5
Pacotes
- packages/paths.md - Utilitários de caminho SVG do @remotion/paths (interpolatePath, warpPath, getLength)
- packages/shapes.md - Primitivos SVG pré-construídos do @remotion/shapes (Triângulo, Círculo, Estrela, Pizza, Coração)
- packages/noise.md - Ruído Perlin com semente do @remotion/noise (noise2D, noise3D, noise4D)
- packages/motion-blur.md - @remotion/motion-blur Trail e CameraMotionBlur (usar com moderação)
- packages/skia.md - @remotion/skia canvas de alto desempenho (React Native Skia)
- packages/rive.md - @remotion/rive animações com máquinas de estado (alternativa ao Lottie)