Communitygithub.com

BolajiOlajide/dotfiles

Melhores práticas para escrever marcação React Remotion.

O que é dotfiles?

Esta habilidade fornece um guia abrangente de melhores práticas para escrever marcação React Remotion de forma eficiente e correta. Ela cobre desde regras gerais de animação com `useCurrentFrame()` e `interpolate()`, uso de `Interactive` para componentes interativos no Studio, até manipulação de assets, sequenciamento, sobreposições de texto, narração, edição de áudio e vídeo, e efeitos visuais. A habilidade também aborda tópicos avançados como conteúdo 3D (Three.js), visualização de áudio, fontes (Google Fonts e locais), animações Lottie, detecção de silêncio, duração dinâmica de composições e muito mais. O guia é essencial para desenvolvedores que desejam criar vídeos programaticamente com Remotion, garantindo que o código siga padrões recomendados para evitar erros comuns, como o uso de transições CSS ou animações Tailwind, e para aproveitar ao máximo o ecossistema Remotion.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BolajiOlajide/dotfiles/tree/HEAD/ai/skills/remotion-markup

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

Este é um guia para escrever marcação React 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 o tempo, incluindo movimentos irregulares ou com excesso de movimento. 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 propriedade 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 shorthand 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 de transformação tornam a edição no Studio mais difícil
const scale = interpolate(frame, [0, 100], [0, 1]);

style={{
  transform: `scale(${scale})`,
}}

Transições ou animações CSS são PROIBIDAS - elas não serão renderizadas corretamente. Nomes de classes de animação do Tailwind são PROIBIDOS - eles não serão renderizados 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 MyComposition = () => {
  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 de <Sequence>. <Sequence> por padrão é um preenchimento absoluto cobrindo a cena. Para conteúdo inline, use layout="none".

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

  return (
    <AbsoluteFill>
      <Sequence name="Background">
        <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>;
};

Destaques e anotações de texto

Consulte text-highlights.md para realces de texto (marcadores de destaque), círculos, sublinhados, tachados, texto riscado, caixas e colchetes.

Locução

Consulte voiceover.md para adicionar locução gerada por IA a composições Remotion usando ElevenLabs TTS.

Corte

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

Incorporação de vídeos

Consulte embedding-videos.md para conhecimento avançado sobre incorporação de vídeos - corte, volume, velocidade, loop, pitch.

Edição de vídeo

Consulte video-editing.md para estruturar linhas do tempo de vídeo editáveis no Remotion Studio.

Incorporação de áudio

Consulte audio.md para recursos avançados de áudio como corte, volume, velocidade, pitch.

Transições

Consulte 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/filter/blend/mask, 2. um efeito listado via effects.md, incluindo em HTML renderizado através de <HtmlInCanvas>, 3. um createEffect() personalizado via effects.md quando o usuário solicitar um efeito reutilizável/específico do projeto, 4. <HtmlInCanvas onPaint> personalizado via html-in-canvas.md apenas se nenhum efeito se adequar.

Para sobreposições de vazamento de luz, consulte light-leaks.md. Docs: 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

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

Efeitos sonoros

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

Visualização de áudio

Quando 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 a habilidade Remotion Captions para mais informações.

Google Fonts

É a maneira recomendada de carregar fontes no Remotion. Consulte google-fonts.md para saber como carregar Google Fonts.

Fontes locais

Consulte local-fonts.md para saber como carregar fontes locais.

GIFs

Consulte gifs.md para saber como exibir GIFs sincronizados com a linha do tempo do Remotion.

Imagens avançadas

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

Animações Lottie

Consulte lottie.md para incorporar animações Lottie no Remotion.

Temporização avançada

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

Vídeos parametrizados

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

Medição de nós DOM

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

Medição de texto

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

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

Quando 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

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

Composições avançadas

Consulte compositions.md para saber como definir stills, pastas, props padrão e como aninhar composições.

Sequenciamento avançado

Consulte sequencing.md para mais padrões de sequenciamento - atraso, corte, limite 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.

Visualizando a marcação

Faça isso apenas se achar que o usuário deseja ver a prévia.

npx remotion studio --no-open

Isso iniciará um processo de longa duração e imprimirá a URL do servidor para a prévia. Se já estiver iniciado, a URL será impressa.

Opcional: verificação de renderização de um quadro

Você pode renderizar um único quadro 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 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).

Individual skills in this repo

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

Habilidades Relacionadas