Communitygithub.com

Ministry-of-Technology-AU/next-platform

Melhores práticas para Remotion - Criação de vídeos em React

O que é next-platform?

Este skill fornece as melhores práticas para trabalhar com Remotion, uma biblioteca que permite criar vídeos programaticamente usando React. Ele abrange desde a configuração inicial de um projeto até a criação de animações complexas, uso de ativos (imagens, vídeos, áudio), manipulação de legendas, detecção de silêncio, e efeitos visuais. O skill é projetado para ser usado com agentes de IA como Claude Code, Cursor e Codex, fornecendo diretrizes claras sobre como estruturar composições, animar propriedades com `useCurrentFrame()` e `interpolate()`, e evitar práticas incorretas como CSS transitions ou animações Tailwind. Além disso, inclui referências a regras especializadas (como subtitles.md, ffmpeg.md, audio-visualization.md) para cenários mais avançados, garantindo que o desenvolvedor ou agente siga um fluxo de trabalho consistente e eficiente. O objetivo é centralizar o conhecimento específico do domínio do Remotion, reduzindo erros e acelerando o desenvolvimento de vídeos dinâmicos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ministry-of-Technology-AU/next-platform/tree/HEAD/.claude/skills/remotion-best-practices

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Prévia

Do README da skill

Documentação

Quando usar

Use este skill sempre que estiver lidando com código Remotion para obter conhecimento específico do domínio.

Configuração de novo projeto

Ao estar em uma pasta vazia ou workspace 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.

Projetando um vídeo

Antes de projetar cenas visuais, layouts, promos, gráficos em movimento ou vídeos com muito texto, carregue rules/video-layout.md para orientação sobre layout focado em vídeo e dimensionamento de texto.

Anime propriedades usando useCurrentFrame() e interpolate(). Prefira interpolate() em vez de spring() a menos que movimento baseado em física seja explicitamente necessário. Use Easing.bezier() para personalizar a temporização, incluindo movimento com saltos ou overshooting.

Para animações que devem ser editáveis no Remotion Studio, mantenha a chamada interpolate() inline no prop style e use propriedades CSS de transformação individuais (scale, translate, rotate) em vez de compor uma string transform.

import { useCurrentFrame, Easing, interpolate, useVideoConfig } from "remotion";

export const FadeIn = () => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();

  const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
    extrapolateRight: "clamp",
    extrapolateLeft: "clamp",
    easing: Easing.bezier(0.16, 1, 0.3, 1),
  });

  return <div style={{ opacity }}>Hello World!</div>;
};

Prefira:

style={{
  scale: interpolate(frame, [0, 100], [0, 1]),
  translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
  rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}

Em vez de:

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 Tailwind são PROIBIDOS - eles não renderizarão corretamente.

Coloque os ativos na pasta public/ na raiz do seu projeto.

Use staticFile() para referenciar arquivos da pasta public/.

Adicione imagens usando o componente <Img>:

import { Img, staticFile } from "remotion";

export const MyComposition = () => {
  return <Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />;
};

Adicione vídeos usando o componente <Video> de @remotion/media:

import { Video } from "@remotion/media";
import { staticFile } from "remotion";

export const MyComposition = () => {
  return <Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />;
};

Adicione áudio usando o componente <Audio> de @remotion/media:

import { Audio } from "@remotion/media";
import { staticFile } from "remotion";

export const MyComposition = () => {
  return <Audio src={staticFile("audio.mp3")} />;
};

Ativos também podem ser referenciados como URLs remotas:

import { Video } from "@remotion/media";

export const MyComposition = () => {
  return <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. Para conteúdo inline, use layout="none".

import { Sequence } from "remotion";

export const Title = () => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();

  const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
    extrapolateRight: "clamp",
    extrapolateLeft: "clamp",
    easing: Easing.bezier(0.16, 1, 0.3, 1),
  });

  return <div style={{ opacity }}>Title</div>;
};

export const Subtitle = () => {
  return <div>Subtitle</div>;
};

const Main = () => {
  const {fps} = useVideoConfig();

  return (
    <AbsoluteFill>
      <Sequence>
        <Background />
      </Sequence>
      <Sequence from={1 * fps} durationInFrames={2 * fps} layout="none">
        <Title />
      </Sequence>
      <Sequence from={2 * fps} durationInFrames={2 * fps} layout="none">
        <Subtitle />
      </Sequence>
    </AbsoluteFill>
  );
}

A largura, altura, fps e duração de um vídeo são definidos em src/Root.tsx:

import { Composition } from "remotion";
import { MyComposition } from "./MyComposition";

export const RemotionRoot = () => {
  return (
    <Composition
      id="MyComposition"
      component={MyComposition}
      durationInFrames={100}
      fps={30}
      width={1080}
      height={1080}
    />
  );
};

Metadados também podem ser calculados dinamicamente:

import { Composition, CalculateMetadataFunction } from "remotion";
import { MyComposition, MyCompositionProps } from "./MyComposition";

const calculateMetadata: CalculateMetadataFunction<
  MyCompositionProps
> = async ({ props, abortSignal }) => {
  const data = await fetch(`https://api.example.com/video/${props.videoId}`, {
    signal: abortSignal,
  }).then((res) => res.json());

  return {
    durationInFrames: Math.ceil(data.duration * 30),
    props: {
      ...props,
      videoUrl: data.url,
    },
    width: 1080,
    height: 1080,
  };
};

export const RemotionRoot = () => {
  return (
    <Composition
      id="MyComposition"
      component={MyComposition}
      fps={30}
      width={1080}
      height={1080}
      defaultProps={{ videoId: "abc123" }}
      calculateMetadata={calculateMetadata}
    />
  );
};

Iniciar preview

Inicie o Remotion Studio para 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

Em 30 fps, --frame=30 é a marca de um segundo (--frame é baseado em zero).

Legendas

Ao lidar com legendas ou subtítulos, carregue o arquivo ./rules/subtitles.md para mais informações.

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 ./rules/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 ./rules/silence-detection.md.

Visualização de áudio

Ao precisar visualizar áudio (barras de espectro, formas de onda, efeitos reativos a graves), carregue o arquivo ./rules/audio-visualization.md para mais informações.

Efeitos sonoros

Ao precisar usar efeitos sonoros, carregue o arquivo ./rules/sfx.md para mais informações.

Efeitos visuais e de pixel

Ao criar um efeito visual, prefira: 1. animação normal Remotion/HTML/CSS/SVG/filtro/blend/máscara, 2. um efeito listado via rules/effects.md, incluindo em HTML renderizado através de <HtmlInCanvas>, 3. um createEffect() customizado via rules/effects.md quando o usuário solicitar um efeito reutilizável/específico do projeto, 4. <HtmlInCanvas onPaint> customizado via rules/html-in-canvas.md apenas se nenhum efeito se adequar.

Para overlays de vazamento de luz, veja rules/light-leaks.md. Documentação: https://www.remotion.dev/docs/effects

Efeitos disponíveis: brightness(), contrast(), colorKey(), duotone(), grayscale(), hue(), invert(), saturation(), tint(), thermalVision(), blur(), linearProgressiveBlur(), zoomBlur(), dropShadow(), glow(), lightTrail(), evolve(), mirror(), scale(), uvTranslate(), xyTranslate(), barrelDistortion(), chromaticAberration(), fisheye(), cornerPin(), wave(), burlap(), emboss(), dotGrid(), halftone(), noise(), noiseDisplacement(), pattern(), pixelate(), pixelDissolve(), scanlines(), speckle(), shine(), shrinkwrap(), vignette(), contourLines(), checkerboard(), halftoneLinearGradient(), gridlines(), whiteNoise(), tvSignalOff(), lines(), rings(), waves(), zigzag(), lightLeak(), starburst().

Conteúdo 3D

Veja rules/3d.md para conteúdo 3D no Remotion usando Three.js e React Three Fiber.

Áudio avançado

Veja rules/audio.md para recursos avançados de áudio como corte, volume, velocidade, tom.

Duração, dimensões e dados dinâmicos

Veja rules/calculate-metadata.md para definir dinamicamente duração, dimensões e props da composição.

Composições avançadas

Veja rules/compositions.md para como definir stills, pastas, props padrão e como aninhar composições.

Google Fonts

É a forma recomendada de carregar fontes no Remotion. Veja rules/google-fonts.md para como carregar Google Fonts.

Fontes locais

Veja rules/local-fonts.md para como carregar fontes locais.

Obtendo duração de áudio

Veja rules/get-audio-duration.md para obter a duração de um arquivo de áudio em segundos com Mediabunny.

Obtendo dimensões de vídeo

Veja rules/get-video-dimensions.md para obter a largura e altura de um arquivo de vídeo com Mediabunny.

Obtendo duração de vídeo

Veja rules/get-video-duration.md para obter a duração de um arquivo de vídeo em segundos com Mediabunny.

GIFs

Veja rules/gifs.md para como exibir GIFs sincronizados com a linha do tempo do Remotion.

Imagens avançadas

Veja rules/images.md para dimensionamento e posicionamento de imagens, caminhos de imagem dinâmicos e obtenção de dimensões de imagem.

Animações Lottie

Veja rules/lottie.md para incorporar animações Lottie no Remotion.

Medindo nós do DOM

Veja rules/measuring-dom-nodes.md para medir dimensões de elementos DOM no Remotion.

Medindo texto

Veja rules/measuring-text.md para medir dimensões de texto, ajustar texto a contêineres e verificar overflow.

Sequenciamento avançado

Veja rules/sequencing.md para mais padrões de sequenciamento - atraso, corte, limitação de duração de itens.

TailwindCSS

Veja rules/tailwind.md para usar TailwindCSS no Remotion.

Animações de texto

Veja rules/text-animations.md para padrões de tipografia e animação de texto.

Temporização avançada

Veja rules/timing.md para temporização avançada com interpolate e easing Bézier, e springs.

Transições

Veja rules/transitions.md para padrões de transição de cena.

Vídeos transparentes

Veja rules/transparent-videos.md para renderizar um vídeo com transparência.

Corte

Veja rules/trimming.md para padrões de corte - cortar o início ou fim de animações.

Vídeos avançados

Veja rules/videos.md para conhecimento avançado sobre incorporação de vídeos - corte, volume, velocidade, loop, tom.

Vídeos parametrizados

Veja rules/parameters.md para tornar uma composição parametrizável adicionando um esquema Zod.

Mapas

Para mapas simples com poucos sobrevoos, considere usar imagens de mapa estáticas. Para mapas complexos com rotas animadas ou sobrevoos, carregue a regra de mapas: rules/maplibre.md

Narração

Veja rules/voiceover.md para adicionar narração gerada por IA a composições Remotion usando ElevenLabs TTS.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Ministry-of-Technology-AU/next-platform

Motion and interaction design expert based on Emil Kowalski, Jakub Krehel, and Jhey Tompkins' techniques. Two modes — build interactive components with purposeful motion, or audit existing animations to catch AI-slop motion patterns (audit emits a branded HTML report with looping demos). Use when creating, adding, animating, or reviewing UI motion: transitions, hover states, micro-interactions, enter/exit animations, or any motion design work in React, Framer Motion, CSS, or HTML. Provides per-designer perspectives with context-aware weighting.

Ministry-of-Technology-AU/next-platform

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames domain skills, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

Ministry-of-Technology-AU/next-platform

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

Habilidades Relacionadas