Communitygithub.com

BolajiOlajide/dotfiles

Best Practices für Remotion React Markup

Was ist dotfiles?

Dieses Skill bietet eine umfassende Anleitung zur Erstellung von Remotion-Kompositionen mit React Markup. Es definiert klare Best Practices, darunter die Verwendung von `useCurrentFrame()` und `interpolate()` für Animationen, die Bevorzugung von `interpolate()` gegenüber `spring()`, sowie die Nutzung von `Easing.bezier()` und `Easing.spring()`. Es wird empfohlen, interaktive HTML-Elemente mit `Interactive` zu versehen, CSS-Transform-Eigenschaften wie `scale`, `translate` und `rotate` zu verwenden und CSS-Übergänge oder -Animationen zu vermeiden. Assets sollten im `public/`-Ordner abgelegt und mit `staticFile()` referenziert werden. Das Skill behandelt zudem fortgeschrittene Themen wie Sequenzierung, Voiceover, Effekte (über 70 verfügbare Effekte), 3D-Inhalte mit Three.js, Untertitel, Schriftarten, GIFs, Lottie-Animationen und vieles mehr. Es ist für Entwickler gedacht, die Remotion im Browser-Studio oder über die CLI nutzen, und bietet klare Codebeispiele sowie Verweise auf spezifische Detaildokumentationen.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Vorschau

Aus dem Skill-README

Dokumentation

Dies ist eine Anleitung zum Schreiben von Remotion React Markup. Wenn dies nicht relevant ist, laden Sie stattdessen Remotion Best Practices.

Allgemeine Regeln

Animieren Sie Eigenschaften mit useCurrentFrame() und interpolate().

Verwenden Sie interpolate() anstelle von spring().

Nutzen Sie Easing.bezier(), um das Timing anzupassen, einschließlich hüpfender oder überschießender Bewegungen. Verwenden Sie Easing.spring(), wenn Sie Feder-Animationen wünschen.

HTML-Elemente, die im Studio interaktiv gemacht werden sollen, sollten Interactive verwenden: <div> -> <Interactive.Div>. Setzen Sie einen beschreibenden name-Prop wie name="Hero title" für 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),
        }),
      }}
    >
      Hello World!
    </Interactive.Div>
  );
};

Behalten Sie den interpolate()-Aufruf inline im style-Prop bei. Bevorzugen Sie die CSS-Eigenschaften scale, translate, rotate gegenüber transform.

// 👍 Inline bearbeitbare Keyframes und Transform-Kurzformen
style={{
  scale: interpolate(frame, [0, 100], [0, 1]),
  translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
  rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}

// 👎 Versteckte Werte und Transform-Strings werden im Studio schwerer zu bearbeiten
const scale = interpolate(frame, [0, 100], [0, 1]);

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

CSS-Übergänge oder -Animationen sind VERBOTEN – sie werden nicht korrekt gerendert. Tailwind-Animation-Klassennamen sind VERBOTEN – sie werden nicht korrekt gerendert.

Platzieren Sie Assets im Ordner public/ im Stammverzeichnis Ihres Projekts.

Verwenden Sie staticFile(), um Dateien aus dem public/-Ordner zu referenzieren.

Fügen Sie Video und Audio mit @remotion/media hinzu. Fügen Sie Bilder mit der <Img>-Komponente hinzu. Verwenden Sie staticFile() für Dateien in public/ oder geben Sie direkt eine Remote-URL an:

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" />
    </>
  );
};

Um Inhalte zu verzögern, umhüllen Sie sie mit <Sequence> und verwenden Sie from. Um die Dauer eines Elements zu begrenzen, verwenden Sie durationInFrames von <Sequence>. <Sequence> ist standardmäßig eine absolute Füllung, die die Szene bedeckt. Für Inline-Inhalte verwenden Sie 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),
        }),
      }}
    >
      Title
    </div>
  );
};

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

Text-Highlights und Anmerkungen

Siehe text-highlights.md für Text-Highlights (Hervorhebungsmarkierungen), Kreise, Unterstreichungen, Durchstreichungen, durchgestrichenen Text, Boxen und Klammern.

Voiceover

Siehe voiceover.md zum Hinzufügen von KI-generiertem Voiceover zu Remotion-Kompositionen mit ElevenLabs TTS.

Trimmung

Siehe trimming.md für Trimm-Muster – das Abschneiden des Anfangs oder Endes von Animationen.

Einbetten von Videos

Siehe embedding-videos.md für fortgeschrittenes Wissen zum Einbetten von Videos – Trimmung, Lautstärke, Geschwindigkeit, Schleifen, Tonhöhe.

Videobearbeitung

Siehe video-editing.md zum Strukturieren bearbeitbarer Video-Zeitachsen im Remotion Studio.

Einbetten von Audio

Siehe audio.md für erweiterte Audiofunktionen wie Trimmung, Lautstärke, Geschwindigkeit, Tonhöhe.

Übergänge

Siehe transitions.md für Szenenübergangsmuster.

Visuelle und Pixeleffekte

Bevorzugen Sie beim Erstellen eines visuellen Effekts: 1. normale Remotion/HTML/CSS/SVG/Filter/Blend/Mask-Animation, 2. einen aufgelisteten Effekt über effects.md, einschließlich auf HTML, das durch <HtmlInCanvas> gerendert wird, 3. einen benutzerdefinierten createEffect() über effects.md, wenn der Benutzer nach einem wiederverwendbaren/projektspezifischen Effekt fragt, 4. benutzerdefiniertes <HtmlInCanvas onPaint> über html-in-canvas.md nur, wenn kein Effekt passt.

Für Light-Leak-Overlays siehe light-leaks.md. Doku: https://www.remotion.dev/docs/effects

Verfügbare Effekte: 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().

3D-Inhalte

Siehe 3d.md für 3D-Inhalte in Remotion mit Three.js und React Three Fiber.

Soundeffekte

Wenn Sie Soundeffekte benötigen, laden Sie die Datei ./sfx.md für weitere Informationen.

Audio-Visualisierung

Wenn Sie Audio visualisieren müssen (Spektrum-Balken, Wellenformen, bassreaktive Effekte), laden Sie die Datei ./audio-visualization.md für weitere Informationen.

Untertitel

Wenn es um Untertitel oder Untertitel (Captions) geht, laden Sie das Skill Remotion Captions für weitere Informationen.

Google Fonts

Dies ist die empfohlene Methode, um Schriftarten in Remotion zu laden. Siehe google-fonts.md zum Laden von Google Fonts.

Lokale Schriftarten

Siehe local-fonts.md zum Laden lokaler Schriftarten.

GIFs

Siehe gifs.md zum Anzeigen von GIFs, die mit der Zeitachse von Remotion synchronisiert sind.

Fortgeschrittene Bilder

Siehe images.md für Größenanpassung und Positionierung von Bildern, dynamische Bildpfade und das Ermitteln von Bildabmessungen.

Lottie-Animationen

Siehe lottie.md zum Einbetten von Lottie-Animationen in Remotion.

Fortgeschrittenes Timing

Siehe timing.md für fortgeschrittenes Timing mit interpolate und Bézier-Easing sowie Federn.

Parametrisierte Videos

Siehe parameters.md zum Parametrisieren einer Komposition durch Hinzufügen eines Zod-Schemas.

Messen von DOM-Knoten

Siehe measuring-dom-nodes.md zum Messen der Abmessungen von DOM-Elementen in Remotion.

Messen von Text

Siehe measuring-text.md zum Messen von Textabmessungen, Anpassen von Text an Container und Überprüfen von Überlauf.

Verwendung von FFmpeg

Für einige Video-Operationen, wie das Trimmen von Videos oder das Erkennen von Stille, sollte FFmpeg verwendet werden. Laden Sie die Datei ./ffmpeg.md für weitere Informationen.

Stille-Erkennung

Wenn Sie stille Segmente aus Video- oder Audiodateien erkennen und trimmen müssen, laden Sie die Datei ./silence-detection.md.

Dynamische Dauer, Abmessungen und Daten

Siehe calculate-metadata.md zum dynamischen Festlegen von Kompositionsdauer, -abmessungen und -Props.

Fortgeschrittene Kompositionen

Siehe compositions.md zur Definition von Standbildern, Ordnern, Standard-Props und zur Verschachtelung von Kompositionen.

Fortgeschrittene Sequenzierung

Siehe sequencing.md für weitere Sequenzierungsmuster – Verzögerung, Trimmung, Begrenzung der Dauer von Elementen.

Module installieren

Verwenden Sie npx remotion add, um neue Pakete mit der richtigen Version hinzuzufügen:

npx remotion add @remotion/media

Dies gilt für @remotion/*-Pakete, mediabunny, @mediabunny/* und zod.

Vorschau des Markups

Führen Sie dies nur aus, wenn Sie glauben, dass der Benutzer die Vorschau sehen möchte.

npx remotion studio --no-open

Dies startet einen langlebigen Prozess und gibt die Server-URL für die Vorschau aus. Wenn bereits gestartet, wird die URL ausgegeben.

Optional: Ein-Frame-Render-Prüfung

Sie können ein einzelnes Frame mit der CLI rendern, um Layout, Farben oder Timing zu überprüfen. Überspringen Sie dies bei trivialen Bearbeitungen, reinen Refactorings oder wenn Sie bereits genügend Vertrauen aus dem Studio oder vorherigen Render-Durchläufen haben.

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

Bei 30 fps ist --frame=30 die Ein-Sekunden-Marke (--frame ist nullbasiert).

Individual skills in this repo

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

Verwandte Skills