Espace de travail Motion
Cet espace de travail produit des graphismes animés reproductibles avec Remotion via le CLI mg (pnpm mg <commande>). Les designs sont du code dans des templates ; chaque valeur spécifique à un projet vit dans un fichier JSON. Un changement de texte, de couleur ou de police est une modification JSON suivie de pnpm mg render, jamais une modification de code.
Structure
mg.json paramètres vidéo par défaut de l'espace de travail (fps, taille)
brand/house.tokens.json tokens maison : couleurs de base, polices, easing, durées, zones de sécurité
brand/fonts/ brand/logos/ fichiers référencés par les tokens maison
clients/<client>/
client.json nom d'affichage, éventuel remplacement vidéo
brand/tokens.json remplacements client (fusion profonde par-dessus la maison)
brand/fonts/ brand/logos/
brand/variants/<variant>/ variante nommée d'aspect alternatif réutilisée par plusieurs projets : tokens.json, fonts/, logos/
templates/<name>/index.tsx templates propres au client, id "<client>/<name>"
projects/<project>/
project.json { title?, extends?: "client"|"none", brand?: "<variant>", video?, preset? }
tokens.json remplacements propres au projet (optionnel)
tokens.lock.json présent quand gelé : les rendus ignorent la chaîne active
fonts/ logos/ assets/ fichiers du projet ; les props référencent les assets comme "asset:<chemin>"
shots/<plan>.props.json { template, props, durationSeconds?, preset?, video? }
renders/ sortie, git-ignorée ; manifest.json suit les versions
Le code de la boîte à outils (moteur, templates maison, ces compétences) se trouve dans node_modules/motion-toolkit, verrouillé par package.json. Ne jamais l'éditer ici ; les modifications des templates maison vont dans le dépôt de la boîte à outils.
Templates maison
Chaque template maison a une prop look : minimal (propre, graisses légères, flou-montée, sans panneaux), bold (typographie lourde en majuscules, blocs de couleur pleins, effet ressort), corporate (panneaux, barres d'accent, révélations par masque). La valeur par défaut "brand" utilise le jeton look, donc un client définit son style une fois dans brand/tokens.json ("look": "minimal").
| Id | Utilisation |
|---|---|
lower-third | Bandeau nom et titre, logo optionnel |
title-card | Titre de chapitre ou de section, accroche et sous-titre optionnels ; superposition ou plein écran |
callout | Ligne partant d'un point dans la vidéo (x, y en fractions d'image) vers une étiquette |
end-card | Carte de fin : logo, titre, CTA, URL, 0–2 emplacements d'écran de fin YouTube |
kinetic-text | Citation ou déclaration révélée mot par mot ; *mot* met en emphase |
logo-sting | Court fondu animé du logo (intro/outro) |
counter | Compteur numérique montant (value, prefix, suffix, decimals) avec une étiquette |
social-handle | Icône de plateforme plus @handle dans un coin (YouTube, Instagram, TikTok, X, LinkedIn, …) |
typewriter | Texte tapé touche par touche avec sons de machine à écrire ou de clavier dans l'audio du rendu |
corner-branding | Logo persistant dans n'importe quel coin, tag optionnel tel que EN DIRECT |
pnpm mg new-shot … --template <id> écrit chaque prop avec sa valeur par défaut. La signification de chaque prop se trouve dans son texte .describe() dans node_modules/motion-toolkit/templates/<id>/index.tsx.
Chaîne de tokens
boîte à outils → maison → client → variante (si project.json "brand") → project tokens.json → props de plan. La couche boîte à outils ne fournit que des valeurs par défaut (le look, une police mono, des sons de frappe). Les objets fusionnent clé par clé, null supprime une clé héritée, et la couche la plus spécifique gagne. "extends": "none" ignore le client et la variante. Les fichiers de police, logo et son sont recherchés dans le dossier fonts/, logos/ ou sounds/ de la couche la plus spécifique qui les contient.
Règles
- Toute valeur visible provient des props de plan ou des tokens. Pas de couleurs, polices, tailles en px sans prop, ou minutages codés en dur dans les templates.
- Les projets contiennent des données, pas du code. Un nouveau design est un template ; un nouveau travail est un projet avec des fichiers de plan.
- Placez une valeur dans la couche la plus basse qui la possède : un seul plan → props de plan ; un seul projet →
tokens.jsondu projet ; plusieurs projets d'un client → une variante ; tout le client → tokens client. - Ne modifiez jamais
tokens.lock.jsonà la main. Les projets livrés sont gelés ; ils ne changent que viamg rebrand(voirmotion-render). - Après chaque modification de JSON ou de template, exécutez
pnpm mg checket corrigez ce qu'il signale avant de lancer un rendu. - Terminez chaque changement visuel par la procédure
motion-qaavant de le déclarer terminé. - Demandez à l'utilisateur avant
mg rebrand --applyet avant de modifier les tokens client ou variante utilisés par des projets gelés. - Si un rendu ou une vérification de diagnostic échoue, exécutez
pnpm mg doctoravant de modifier le code.
Routage
| Tâche | À lire |
|---|---|
| Nouveau client, variante, logo, police, palette de couleurs | motion-brand |
| Nouveau projet ou plans à partir d'un brief ; modifier texte/couleurs sur des plans existants | motion-project |
| Nouveau template ou modification de l'animation d'un template | motion-template, puis motion-style |
| Sensation de mouvement : easing, timing, décalage, zones de sécurité | motion-style |
| Rendu, préréglages, versions, livraison, application de changements de marque | motion-render |
| Vérification du rendu avant remise | motion-qa |
Commandes
pnpm mg templates lister les ids de templates
pnpm mg new-client|new-variant|new-project …
pnpm mg new-shot <client>/<projet> <plan> --template <id> fichier de plan avec toutes les props par défaut
pnpm mg new-template <client> <nom> template de démarrage
pnpm mg check [<client> | <client>/<projet>] valider tout sans rendu
pnpm mg render <client>/<projet> [plan…] ignore les plans inchangés ; --force, --preset
pnpm mg still <client>/<projet> [plan…] aperçus PNG sur un damier (tous les plans par défaut)
pnpm mg studio <client>/<projet> aperçu en direct ; Studio "Enregistrer" écrit le fichier de plan
pnpm mg deliver <client>/<projet> rendu, vérification, gel, copie des finals vers deliver/<date>/
pnpm mg rebrand <client | client/projet> [--apply] changements de marque pour le travail livré
pnpm mg freeze|unfreeze|diff <client>/<projet>
pnpm mg doctor environnement, mg check, rendu test