Este é um guia para escrever markup React com Remotion. Se não for relevante, carregue Remotion Best Practices.
Regras gerais
Anime propriedades usando useCurrentFrame() e interpolate().
Use interpolate() em vez de spring().
Use Easing.bezier() para personalizar temporização, incluindo movimentos bruscos ou com overshoot.
Use Easing.spring() se quiser animações spring.
Elementos HTML que façam sentido serem interativos no Studio devem usar Interactive: <div> -> <Interactive.Div>.
Defina uma name descritiva, como name="Título do herói" para Interactive, Solid, Sequence.
import { useCurrentFrame, Easing, interpolate, Interactive } from "remotion";
export const FadeIn = () => {
const frame = useCurrentFrame();
return (
<Interactive.Div
name="Título"
style={{
opacity: interpolate(frame, [0, 60], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
}),
}}
>
Olá Mundo!
</Interactive.Div>
);
};
Mantenha a chamada interpolate() inline na prop style.
Prefira as propriedades CSS scale, translate, rotate em vez de transform.
// 👍 Keyframes editáveis inline e shorthands de transformação
style={{
scale: interpolate(frame, [0, 100], [0, 1]),
translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}
// 👎 Valores ocultos e strings transform tornam-se mais difíceis de editar no Studio
const scale = interpolate(frame, [0, 100], [0, 1]);
style={{
transform: `scale(${scale})`,
}}
Transições ou animações CSS são PROIBIDAS — elas não renderizarão corretamente. Nomes de classes de animação do Tailwind são PROIBIDOS — eles não renderizarão corretamente.
Coloque os assets na pasta public/ na raiz do seu projeto.
Use staticFile() para referenciar arquivos da pasta public/.
Adicione vídeo e áudio usando @remotion/media.
Adicione imagens usando o componente <Img>.
Use staticFile() para arquivos em public/ ou passe uma URL remota diretamente:
import { Audio, Video } from "@remotion/media";
import { staticFile } from "remotion";
export const MinhaComposição = () => {
return (
<>
<Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />
<Audio src={staticFile("audio.mp3")} />
<Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />
<Video src="https://remotion.media/video.mp4" />
</>
);
};
Para atrasar conteúdo, envolva-o em <Sequence> e use from.
Para limitar a duração de um elemento, use durationInFrames do <Sequence>.
Por padrão, <Sequence> é um preenchimento absoluto cobrindo a cena.
Para conteúdo inline, use layout="none".
const Main = () => {
const {fps} = useVideoConfig();
return (
<AbsoluteFill>
<Sequence name="Fundo">
<Background />
</Sequence>
<Sequence name="Título" from={30} durationInFrames={60} layout="none">
<Title />
</Sequence>
<Sequence name="Subtítulo" from={60} durationInFrames={60} layout="none">
<Subtitle />
</Sequence>
</AbsoluteFill>
);
}
export const Title = () => {
const frame = useCurrentFrame();
return (
<div
style={{
opacity: interpolate(frame, [0, 60], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
}),
}}
>
Título
</div>
);
};
export const Subtitle = () => {
return <div>Subtítulo</div>;
};
Mapas
Veja map.md para escolher entre mapas estáticos simples, mapas Mapbox e mapas MapLibre.
Narração
Veja voiceover.md para adicionar narração gerada por IA a composições Remotion usando ElevenLabs TTS.
Corte
Veja trimming.md para padrões de corte – removendo o início ou o fim de animações.
Incorporação de vídeos
Veja embedding-videos.md para conhecimento avançado sobre incorporação de vídeos – corte, volume, velocidade, loop, pitch.
Incorporação de áudio
Veja audio.md para funcionalidades avançadas de áudio como corte, volume, velocidade, pitch.
Transições
Veja transitions.md para padrões de transição de cena.
Efeitos visuais e de pixel
Ao criar um efeito visual, prefira: 1. animação normal Remotion/HTML/CSS/SVG/filtro/sobreposição/máscara, 2. um efeito listado via effects.md, inclusive em HTML renderizado através de <HtmlInCanvas>, 3. um createEffect() personalizado via effects.md quando o usuário solicitar um efeito reutilizável ou específico do projeto, 4. <HtmlInCanvas onPaint> personalizado via html-in-canvas.md apenas se nenhum efeito atender.
Para sobreposições de vazamento de luz, veja light-leaks.md. Documentação: https://www.remotion.dev/docs/effects
Efeitos disponíveis: brightness(), contrast(), colorKey(), duotone(), grayscale(), hue(), invert(), saturation(), tint(), linearGradient(), linearGradientTint(), thermalVision(), blur(), linearProgressiveBlur(), radialProgressiveBlur(), zoomBlur(), dropShadow(), glow(), lightTrail(), evolve(), venetianBlinds(), mirror(), scale(), uvTranslate(), xyTranslate(), barrelDistortion(), chromaticAberration(), fisheye(), cornerPin(), wave(), burlap(), emboss(), dotGrid(), halftone(), noise(), noiseDisplacement(), paper(), roughenEdges(), pattern(), pixelate(), pixelDissolve(), scanlines(), speckle(), shine(), shrinkwrap(), vignette(), contourLines(), checkerboard(), halftoneLinearGradient(), gridlines(), whiteNoise(), tvSignalOff(), lines(), rings(), waves(), zigzag(), lightLeak(), starburst().
Conteúdo 3D
Veja 3d.md para conteúdo 3D no Remotion usando Three.js e React Three Fiber.
Efeitos sonoros
Ao precisar usar efeitos sonoros, carregue o arquivo ./sfx.md para mais informações.
Visualização de áudio
Ao precisar visualizar áudio (barras de espectro, formas de onda, efeitos reativos a graves), carregue o arquivo ./audio-visualization.md para mais informações.
Legendas
Ao lidar com legendas ou subtítulos, carregue o skill Remotion Captions para mais informações.
Google Fonts
É a forma recomendada de carregar fontes no Remotion. Veja google-fonts.md sobre como carregar Google Fonts.
Fontes locais
Veja local-fonts.md sobre como carregar fontes locais.
GIFs
Veja gifs.md sobre como exibir GIFs sincronizados com a linha do tempo do Remotion.
Imagens avançadas
Veja images.md sobre dimensionamento e posicionamento de imagens, caminhos dinâmicos de imagem e obtenção de dimensões de imagem.
Animações Lottie
Veja lottie.md para incorporar animações Lottie no Remotion.
Temporização avançada
Veja timing.md para temporização avançada com interpolate e easing Bézier, e springs.
Vídeos parametrizados
Veja parameters.md para tornar uma composição parametrizável adicionando um esquema Zod.
Medição de nós DOM
Veja measuring-dom-nodes.md para medir dimensões de elementos DOM no Remotion.
Medição de texto
Veja measuring-text.md para medir dimensões de texto, ajustar texto a contêineres e verificar estouro.
Usando FFmpeg
Para algumas operações de vídeo, como cortar vídeos ou detectar silêncio, o FFmpeg deve ser usado. Carregue o arquivo ./ffmpeg.md para mais informações.
Detecção de silêncio
Ao precisar detectar e cortar segmentos silenciosos de arquivos de vídeo ou áudio, carregue o arquivo ./silence-detection.md.
Duração, dimensões e dados dinâmicos
Veja calculate-metadata.md para definir dinamicamente duração, dimensões e props da composição.
Composições avançadas
Veja compositions.md sobre como definir stills, pastas, props padrão e como aninhar composições.
Sequenciamento avançado
Veja sequencing.md para mais padrões de sequenciamento – atraso, corte, limitação de duração de itens.
Instalar módulos
Use npx remotion add para adicionar novos pacotes com a versão correta:
npx remotion add @remotion/media
Isso vale para pacotes @remotion/*, mediabunny, @mediabunny/* e zod.
Pré-visualizando markup
Faça isso apenas se achar que o usuário deseja ver a pré-visualização.
npx remotion studio --no-open
Isso iniciará um processo de longa duração e exibirá a URL do servidor para a pré-visualização. Se já estiver iniciado, a URL será exibida.
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 [id-da-composição] --scale=0.25 --frame=30
A 30 fps, --frame=30 é o marco de um segundo (--frame é baseado em zero).