Communitygithub.com

BolajiOlajide/dotfiles

Mejores prácticas para escribir marcado React en Remotion

¿Qué es dotfiles?

Este skill proporciona una guía completa de mejores prácticas para desarrollar composiciones de video animado con Remotion. Enseña a usar correctamente `useCurrentFrame()` e `interpolate()` para animar propiedades, favoreciendo `interpolate()` sobre `spring()` y utilizando `Easing.bezier()` o `Easing.spring()` para personalizar la temporización. Recomienda mantener las llamadas a `interpolate()` inline en el prop `style` y usar propiedades CSS como `scale`, `translate` y `rotate` en lugar de `transform` para facilitar la edición en el Studio. Prohíbe el uso de transiciones y animaciones CSS, así como clases de animación de Tailwind, ya que no se renderizan correctamente. Incluye pautas para gestionar activos multimedia con `staticFile()` y los componentes `Audio`, `Video` e `Img` de Remotion, así como para estructurar contenido temporal con `<Sequence>` usando los props `from`, `durationInFrames` y `layout="none"`. También referencia documentación adicional sobre aspectos avanzados como iluminación, voz en off, recorte, edición de video, audio, transiciones y efectos visuales. Está diseñado para la plataforma Remotion y es útil para desarrolladores que buscan crear animaciones precisas, editables y de alto rendimiento en sus proyectos de video con React.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Vista previa

Del README del skill

Documentación

Esta es una guía para escribir marcado React en Remotion. Si esto no es relevante, carga Remotion Best Practices en su lugar.

Reglas generales

Anima propiedades usando useCurrentFrame() y interpolate().

Usa interpolate() en lugar de spring().

Usa Easing.bezier() para personalizar la temporización, incluyendo movimientos bruscos o con sobreimpulso. Usa Easing.spring() si deseas animaciones con resorte.

Los elementos HTML que tengan sentido ser interactivos en el Estudio deben usar Interactive: <div> -> <Interactive.Div>.
Asigna una propiedad name descriptiva como name="Título principal" para Interactive, Solid, Sequence.

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

export const FadeIn = () => {
  const frame = useCurrentFrame();

  return (
    <Interactive.Div
      name="Title"
      style={{
        opacity: interpolate(frame, [0, 60], [0, 1], {
          extrapolateRight: "clamp",
          extrapolateLeft: "clamp",
          easing: Easing.bezier(0.16, 1, 0.3, 1),
        }),
      }}
    >
      ¡Hola Mundo!
    </Interactive.Div>
  );
};

Mantén la llamada a interpolate() en línea dentro de la propiedad style. Prefiere las propiedades CSS scale, translate, rotate sobre transform.

// 👍 Fotogramas clave editables en línea y abreviaturas de transformación
style={{
  scale: interpolate(frame, [0, 100], [0, 1]),
  translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
  rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}

// 👎 Los valores ocultos y las cadenas de transformación se vuelven más difíciles de editar en el Estudio
const scale = interpolate(frame, [0, 100], [0, 1]);

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

Las transiciones o animaciones CSS están PROHIBIDAS: no se renderizarán correctamente.
Los nombres de clase de animación de Tailwind están PROHIBIDOS: no se renderizarán correctamente.

Coloca los recursos en la carpeta public/ en la raíz de tu proyecto.

Usa staticFile() para hacer referencia a archivos desde la carpeta public/.

Añade video y audio usando @remotion/media.
Añade imágenes usando el componente <Img>. Usa staticFile() para archivos en public/ o pasa una URL remota directamente:

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 retrasar contenido, envuélvelo en <Sequence> y usa from. Para limitar la duración de un elemento, usa durationInFrames de <Sequence>. <Sequence> por defecto es un relleno absoluto que cubre la escena.
Para contenido en línea, usa layout="none".

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

  return (
    <AbsoluteFill>
      <Sequence name="Background">
        <Background />
      </Sequence>
      <Sequence name="Title" from={30} durationInFrames={60} layout="none">
        <Title />
      </Sequence>
      <Sequence name="Subtitle" 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>;
};

Resaltados y anotaciones de texto

Consulta text-highlights.md para resaltados de texto (marcadores de resaltado), círculos, subrayados, tachados, texto cancelado, cuadros y corchetes.

Voz en off

Consulta voiceover.md para agregar voz en off generada por IA a composiciones de Remotion usando ElevenLabs TTS.

Recorte

Consulta trimming.md para patrones de recorte: cortar el inicio o el final de las animaciones.

Incrustación de videos

Consulta embedding-videos.md para conocimientos avanzados sobre la incrustación de videos: recorte, volumen, velocidad, bucle, tono.

Edición de video

Consulta video-editing.md para estructurar líneas de tiempo de video editables en Remotion Studio.

Incrustación de audio

Consulta audio.md para funciones de audio avanzadas como recorte, volumen, velocidad, tono.

Transiciones

Consulta transitions.md para patrones de transición de escenas.

Efectos visuales y de píxeles

Al crear un efecto visual, prefiere: 1. Animación normal de Remotion/HTML/CSS/SVG/filtro/mezcla/máscara, 2. un efecto listado a través de effects.md, incluso en HTML renderizado a través de <HtmlInCanvas>, 3. un createEffect() personalizado a través de effects.md cuando el usuario solicite un efecto reutilizable/específico del proyecto, 4. <HtmlInCanvas onPaint> personalizado a través de html-in-canvas.md solo si ningún efecto se ajusta.

Para superposiciones de fugas de luz, consulta light-leaks.md. Documentos: https://www.remotion.dev/docs/effects

Efectos disponibles: 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().

Contenido 3D

Consulta 3d.md para contenido 3D en Remotion usando Three.js y React Three Fiber.

Efectos de sonido

Cuando necesites usar efectos de sonido, carga el archivo ./sfx.md para más información.

Visualización de audio

Cuando necesites visualizar audio (barras de espectro, formas de onda, efectos reactivos a graves), carga el archivo ./audio-visualization.md para más información.

Subtítulos

Cuando se trate de subtítulos o leyendas, carga la habilidad Remotion Captions para más información.

Google Fonts

Es la forma recomendada de cargar fuentes en Remotion. Consulta google-fonts.md para saber cómo cargar Google Fonts.

Fuentes locales

Consulta local-fonts.md para saber cómo cargar fuentes locales.

GIFs

Consulta gifs.md para saber cómo mostrar GIFs sincronizados con la línea de tiempo de Remotion.

Imágenes avanzadas

Consulta images.md para dimensionar y posicionar imágenes, rutas de imágenes dinámicas y obtener dimensiones de imágenes.

Animaciones Lottie

Consulta lottie.md para incrustar animaciones Lottie en Remotion.

Temporización avanzada

Consulta timing.md para la temporización avanzada con interpolate y easing Bézier, y resortes.

Videos parametrizados

Consulta parameters.md para hacer una composición parametrizable agregando un esquema Zod.

Medición de nodos DOM

Consulta measuring-dom-nodes.md para medir las dimensiones de elementos DOM en Remotion.

Medición de texto

Consulta measuring-text.md para medir dimensiones de texto, ajustar texto a contenedores y verificar desbordamiento.

Uso de FFmpeg

Para algunas operaciones de video, como recortar videos o detectar silencio, se debe usar FFmpeg. Carga el archivo ./ffmpeg.md para más información.

Detección de silencio

Cuando necesites detectar y recortar segmentos silenciosos de archivos de video o audio, carga el archivo ./silence-detection.md.

Duración, dimensiones y datos dinámicos

Consulta calculate-metadata.md para configurar dinámicamente la duración, dimensiones y propiedades de la composición.

Composiciones avanzadas

Consulta compositions.md para saber cómo definir imágenes fijas, carpetas, propiedades predeterminadas y cómo anidar composiciones.

Secuenciación avanzada

Consulta sequencing.md para más patrones de secuenciación: retraso, recorte, limitación de duración de elementos.

Instalar módulos

Usa npx remotion add para agregar nuevos paquetes con la versión correcta:

npx remotion add @remotion/media

Esto aplica para paquetes @remotion/*, mediabunny, @mediabunny/* y zod.

Vista previa del marcado

Haz esto solo si crees que el usuario quiere ver la vista previa.

npx remotion studio --no-open

Esto iniciará un proceso de larga duración e imprimirá la URL del servidor para la vista previa.
Si ya está iniciado, se imprimirá la URL.

Opcional: verificación de renderizado de un fotograma

Puedes renderizar un solo fotograma con la CLI para verificar el diseño, los colores o la temporización.
Omítelo para ediciones triviales, refactorizaciones puras, o cuando ya tengas suficiente confianza del Estudio o renderizados anteriores.

npx remotion still [composition-id] --scale=0.25 --frame=30

A 30 fps, --frame=30 es la marca de un segundo (--frame comienza en 0).

Individual skills in this repo

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

Skills relacionados