Compétence Vidéo de Démonstration Remotion
Cette compétence aide à construire et maintenir la vidéo de démonstration Remotion située dans :
demos/wallrun-video
Elle fournit une structure pour :
- la création de scènes
- la structure de composition
- les composants de mouvement réutilisables
- le rythme vidéo
- les explications destinées aux développeurs
Cette compétence doit être utilisée lorsque vous travaillez sur :
- des compositions Remotion
- des composants de scène
- des segments d'explication animés
- la structure ou le séquencement vidéo
- les primitives de mouvement utilisées par la démo
Contexte du projet
Ce dépôt est un monorepo Nx.
La vidéo Remotion se trouve dans :
demos/wallrun-video
Le projet rend une vidéo explicative destinée aux développeurs pour WallRun.
Le public est constitué de développeurs frontend, pas de spécialistes du marketing.
On suppose que le spectateur comprend :
- React
- TypeScript
- l'architecture des composants
- les systèmes de mise en page
- les outils pour développeurs
Évitez d'expliquer les concepts JavaScript de base.
Intention de conception
La vidéo doit ressembler à un contenu pour développeurs, pas à une publicité produit.
Bon ton :
- éditorial
- minimal
- moderne
- confiant
- mouvement retenu
Mauvais ton :
- promotion SaaS générique
- effets de bande-annonce cinématographique
- animations lourdes de particules
- texte marketing dense
Priorisez :
- la lisibilité
- la hiérarchie
- le rythme
- la clarté
Structure du projet
Tout le code doit se trouver dans :
demos/wallrun-video/src
Structure :
- components/ — Primitives de présentation réutilisables
- scenes/ — Sections chronométrées de la vidéo
- data/ — Script, texte, constantes de tempo
- Root.tsx — Enregistre les compositions
- index.ts — Fichier d'entrée pour la CLI Remotion
Règles de conception des scènes
Chaque scène doit communiquer une seule idée.
Durée typique : 4 à 8 secondes
Les scènes doivent :
- se lire rapidement
- avoir une typographie large
- éviter l'encombrement
- garder le mouvement subtil
Types de scènes préférés :
- cartes-titres
- captures d'écran de dépôt scénarisées
- gros plans de composants
- superpositions d'encadrés
- diagrammes d'architecture
- panneaux de statistiques
Évitez :
- les petites interfaces utilisateur
- les longs paragraphes
- les transitions trop compliquées
Directives d'animation
Préférez une animation simple et déterministe.
Exemples :
- fondu
- glissement vers le haut
- dévoilement progressif
- échelle subtile
Évitez :
- les effets de rebond
- le mouvement physique complexe
- les courbes d'assouplissement lourdes
Le but est la clarté, pas le spectacle.
Conventions de codage
Utilisez :
- des composants fonctionnels React
- TypeScript
- des exports nommés
- des types explicites
- des wrappers de mouvement réutilisables
Évitez :
- le code d'animation dupliqué
- les nombres magiques
- le cadrage temporel des scènes codé en dur
Extrayez les constantes de tempo lorsque c'est pratique.
Exemple :
const TITLE_FADE_IN = 20;
const CALLOUT_DELAY = 15;
Workflow par défaut pour créer une nouvelle scène
- Définissez le message de la scène
- Définissez la durée en images
- Bloquez la mise en page
- Ajoutez le mouvement principal
- Ajoutez le mouvement secondaire uniquement s'il améliore la clarté
- Vérifiez la lisibilité
- Assurez-vous que le code est réutilisable
Cibles Nx
- preview —
nx preview wallrun-videoouvre Remotion Studio - render —
nx render wallrun-videorend la vidéo complète dansdist/demos/wallrun-video/ - type-check —
nx type-check wallrun-videoexécute le compilateur TypeScript
Définition de terminé
Une scène est terminée lorsque :
- le message est immédiatement clair
- la typographie se lit à l'échelle vidéo
- l'animation est sobre
- les minutages sont faciles à modifier
- le code est structuré proprement