Communitygithub.com

BolajiOlajide/dotfiles

Bonnes pratiques pour écrire du code React Remotion

Qu'est-ce que dotfiles ?

Ce skill fournit des bonnes pratiques complètes et des modèles pour écrire du code React Remotion, en se concentrant sur les animations, la gestion des médias, et l'organisation des compositions. Il couvre l'utilisation de `useCurrentFrame()` et `interpolate()` pour les animations, les transformations CSS (scale, translate, rotate) plutôt que la propriété `transform`, et l'importation des assets via `staticFile()`. Il déconseille fortement les transitions et animations CSS. Le skill propose également des modules spécialisés pour les surlignages de texte, le voiceover (ElevenLabs), le trimming, l'embedding de vidéos et d'audio, les transitions de scène, les effets visuels et pixels, les contenus 3D (Three.js), les effets sonores, la visualisation audio, les légendes, les polices Google et locales, les GIFs, les images avancées, les animations Lottie, le timing avancé, les vidéos paramétrables, la mesure de nœuds DOM et de texte, l'utilisation de FFmpeg, la détection de silence, la durée et dimensions dynamiques, les compositions avancées, et le séquençage avancé. Il est destiné aux développeurs utilisant Remotion Studio pour créer des vidéos programmatiques avec React, et fonctionne avec tout environnement supportant Remotion (CLI, Studio).

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Aperçu

Depuis le README du skill

Documentation

Ce guide fournit des bonnes pratiques pour écrire du code React Remotion. Si cela n'est pas pertinent, chargez plutôt Remotion Best Practices.

Règles générales

Animez les propriétés en utilisant useCurrentFrame() et interpolate().

Utilisez interpolate() de préférence à spring().

Utilisez Easing.bezier() pour personnaliser le timing, y compris les mouvements saccadés ou avec dépassement. Utilisez Easing.spring() si vous voulez des animations à ressort.

Les éléments HTML qui ont un intérêt à être interactifs dans le Studio doivent utiliser Interactive : <div> -> <Interactive.Div>. Définissez une propriété name descriptive telle que name="Titre Hero" pour Interactive, Solid, Sequence.

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

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

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

Gardez l'appel interpolate() en ligne dans la propriété style. Préférez les propriétés CSS scale, translate, rotate à transform.

// 👍 Images clés modifiables en ligne et raccourcis de transformation
style={{
  scale: interpolate(frame, [0, 100], [0, 1]),
  translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
  rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}

// 👎 Les valeurs cachées et les chaînes de transformation deviennent plus difficiles à éditer dans Studio
const scale = interpolate(frame, [0, 100], [0, 1]);

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

Les transitions ou animations CSS sont INTERDITES – elles ne seront pas rendues correctement. Les noms de classes d'animation Tailwind sont INTERDITS – ils ne seront pas rendus correctement.

Placez les assets dans le dossier public/ à la racine de votre projet.

Utilisez staticFile() pour référencer les fichiers du dossier public/.

Ajoutez la vidéo et l'audio en utilisant @remotion/media. Ajoutez les images en utilisant le composant <Img>. Utilisez staticFile() pour les fichiers dans public/ ou passez une URL distante directement :

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

Pour retarder le contenu, enveloppez-le dans <Sequence> et utilisez from. Pour limiter la durée d'un élément, utilisez durationInFrames de <Sequence>. <Sequence> par défaut est un remplissage absolu couvrant la scène. Pour le contenu en ligne, utilisez layout="none".

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

  return (
    <AbsoluteFill>
      <Sequence name="Arrière-plan">
        <Background />
      </Sequence>
      <Sequence name="Titre" from={30} durationInFrames={60} layout="none">
        <Title />
      </Sequence>
      <Sequence name="Sous-titre" 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),
        }),
      }}
    >
      Titre
    </div>
  );
};

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

Surlignages et annotations de texte

Voir text-highlights.md pour les surlignages de texte (marqueurs de surlignage), cercles, soulignements, barrés, texte rayé, boîtes et crochets.

Voiceover

Voir voiceover.md pour ajouter un voiceover généré par IA aux compositions Remotion en utilisant ElevenLabs TTS.

Recadrage (Trimming)

Voir trimming.md pour les modèles de recadrage – couper le début ou la fin des animations.

Intégration de vidéos

Voir embedding-videos.md pour des connaissances avancées sur l'intégration de vidéos – recadrage, volume, vitesse, boucle, tonalité.

Montage vidéo

Voir video-editing.md pour structurer des timelines vidéo modifiables dans Remotion Studio.

Intégration audio

Voir audio.md pour les fonctionnalités audio avancées comme le recadrage, le volume, la vitesse, la tonalité.

Transitions

Voir transitions.md pour les modèles de transition de scène.

Effets visuels et pixel

Lors de la création d'un effet visuel, préférez : 1. une animation normale Remotion/HTML/CSS/SVG/filtre/mélange/masque, 2. un effet listé via effects.md, y compris sur le HTML rendu via <HtmlInCanvas>, 3. un createEffect() personnalisé via effects.md lorsque l'utilisateur demande un effet réutilisable/propre au projet, 4. un <HtmlInCanvas onPaint> personnalisé via html-in-canvas.md seulement si aucun effet ne convient.

Pour les superpositions de fuite de lumière, voir light-leaks.md. Docs : https://www.remotion.dev/docs/effects

Effets 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().

Contenu 3D

Voir 3d.md pour le contenu 3D dans Remotion avec Three.js et React Three Fiber.

Effets sonores

Lorsque vous devez utiliser des effets sonores, chargez le fichier ./sfx.md pour plus d'informations.

Visualisation audio

Lorsque vous devez visualiser de l'audio (barres de spectre, formes d'onde, effets réactifs aux basses), chargez le fichier ./audio-visualization.md pour plus d'informations.

Légendes

Lorsque vous traitez des légendes ou sous-titres, chargez le skill Remotion Captions pour plus d'informations.

Polices Google

Est la méthode recommandée pour charger les polices dans Remotion. Voir google-fonts.md pour savoir comment charger les polices Google.

Polices locales

Voir local-fonts.md pour savoir comment charger les polices locales.

GIFs

Voir gifs.md pour savoir comment afficher des GIFs synchronisés avec la timeline de Remotion.

Images avancées

Voir images.md pour le dimensionnement et le positionnement des images, les chemins d'images dynamiques et l'obtention des dimensions des images.

Animations Lottie

Voir lottie.md pour intégrer des animations Lottie dans Remotion.

Timing avancé

Voir timing.md pour le timing avancé avec interpolate et l'assouplissement Bézier, ainsi que les ressorts.

Vidéos paramétrables

Voir parameters.md pour rendre une composition paramétrable en ajoutant un schéma Zod.

Mesure des nœuds DOM

Voir measuring-dom-nodes.md pour mesurer les dimensions des éléments DOM dans Remotion.

Mesure du texte

Voir measuring-text.md pour mesurer les dimensions du texte, adapter le texte aux conteneurs et vérifier le débordement.

Utilisation de FFmpeg

Pour certaines opérations vidéo, comme le recadrage de vidéos ou la détection de silence, FFmpeg doit être utilisé. Chargez le fichier ./ffmpeg.md pour plus d'informations.

Détection de silence

Lorsque vous devez détecter et supprimer les segments silencieux de fichiers vidéo ou audio, chargez le fichier ./silence-detection.md.

Durée, dimensions et données dynamiques

Voir calculate-metadata.md pour définir dynamiquement la durée, les dimensions et les props de la composition.

Compositions avancées

Voir compositions.md pour savoir comment définir des images fixes, des dossiers, des props par défaut et comment imbriquer des compositions.

Séquençage avancé

Voir sequencing.md pour plus de modèles de séquençage – délai, recadrage, limitation de la durée des éléments.

Installation de modules

Utilisez npx remotion add pour ajouter de nouveaux packages avec la bonne version :

npx remotion add @remotion/media

Cela s'applique aux packages @remotion/*, mediabunny, @mediabunny/* et zod.

Aperçu du code

Faites-le uniquement si vous pensez que l'utilisateur souhaite voir l'aperçu.

npx remotion studio --no-open

Cela démarrera un processus de longue durée et affichera l'URL du serveur pour l'aperçu. S'il est déjà démarré, l'URL sera affichée.

Optionnel : vérification du rendu d'une seule image

Vous pouvez rendre une seule image avec la CLI pour vérifier la mise en page, les couleurs ou le timing. Ignorer pour les modifications triviales, les refontes pures, ou lorsque vous avez déjà suffisamment confiance grâce au Studio ou aux rendus précédents.

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

À 30 ips, --frame=30 correspond à la marque d'une seconde (--frame est basé sur zéro).

Individual skills in this repo

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

Skills associés