Motion-Workspace
Dieser Workspace rendert wiederholbare Bewegtgrafiken mit Remotion über die mg-CLI (pnpm mg <command>). Designs sind Code in Vorlagen; jeder auftragsspezifische Wert lebt in JSON. Eine Text-, Farb- oder Schriftartenänderung ist eine JSON-Bearbeitung plus pnpm mg render, nie eine Code-Änderung.
Layout
mg.json Video-Standardeinstellungen des Workspaces (fps, Größe)
brand/house.tokens.json Haus-Tokens: Basis-Farben, Schriftarten, Easing, Dauern, Sicherheitsbereiche
brand/fonts/ brand/logos/ Dateien, auf die die Haus-Tokens verweisen
clients/<client/>/
client.json Anzeigename, optionales Video-Override
brand/tokens.json Kunden-Overrides (tief zusammengeführt über Haus)
brand/fonts/ brand/logos/
brand/variants/<variant>/ benannter alternativer Look, der von mehreren Projekten wiederverwendet wird: tokens.json, fonts/, logos/
templates/<name>/index.tsx Nur-Kunden-Vorlagen, Id "<client>/<name>"
projects/<project>/
project.json { title?, extends?: "client"|"none", brand?: "<variant>", video?, preset? }
tokens.json Nur-Projekt-Overrides (optional)
tokens.lock.json vorhanden, wenn eingefroren: Rendering ignoriert die Live-Kette
fonts/ logos/ assets/ Projektdateien; Props verweisen auf Assets als "asset:<pfad>"
shots/<shot>.props.json { template, props, durationSeconds?, preset?, video? }
renders/ Ausgabe, von git ignoriert; manifest.json verfolgt Versionen
Toolkit-Code (Engine, Hausvorlagen, diese Skills) lebt in node_modules/motion-toolkit, gepinnt durch package.json. Niemals dort bearbeiten; Änderungen an Hausvorlagen gehen in das Toolkit-Repository.
Hausvorlagen
Jede Hausvorlage hat eine look-Prop: minimal (sauber, leichte Schriftgewichte, Weichzeichner-Aufstieg, keine Panels), bold (schwere Großbuchstaben, feste Farbblöcke, Spring-Pop), corporate (Panels, Akzentbalken, Masken-Enthüllungen). Der Standardwert "brand" verwendet das look-Token, sodass ein Kunde seinen Stil einmal in brand/tokens.json setzt ("look": "minimal").
| Id | Verwendung |
|---|---|
lower-third | Name- und Titel-Band, optionales Logo |
title-card | Kapitel- oder Abschnittstitel, optionaler Aufmacher und Untertitel; Overlay oder Vollbild |
callout | Linie von einem Punkt im Filmmaterial (x, y als Bildanteile) zu einer Beschriftung |
end-card | Abschlusskarte: Logo, Überschrift, CTA, URL, 0–2 YouTube-Endbildschirm-Slots |
kinetic-text | Zitat oder Aussage, Wort für Wort enthüllt; *wort* betont |
logo-sting | Kurze animierte Logo-Enthüllung (Intro/Outro) |
counter | Hochzählende Zahl (value, prefix, suffix, decimals) mit einer Beschriftung |
social-handle | Plattformsymbol plus @handle in einer Ecke (YouTube, Instagram, TikTok, X, LinkedIn, …) |
typewriter | Text Buchstabe für Buchstabe getippt mit Schreibmaschinen- oder Tastaturgeräuschen im Rendering-Audio |
corner-branding | Permanentes Logo-Wasserzeichen in einer beliebigen Ecke, optionaler Tag wie LIVE |
pnpm mg new-shot … --template <id> schreibt jede Prop mit ihrem Standardwert. Die Bedeutung jeder Prop steht im .describe()-Text in node_modules/motion-toolkit/templates/<id>/index.tsx.
Token-Kaskade
toolkit → haus → kunde → variante (falls projekt.json "brand") → project tokens.json → shot props. Die Toolkit-Ebene liefert nur Standardwerte (den Look, eine mono-Schrift, Tipp sounds). Objekte werden Schlüssel für Schlüssel zusammengeführt, null löscht einen geerbten Schlüssel, und die spezifischste Ebene gewinnt. "extends": "none" überspringt Kunde und Variante. Schrift-, Logo- und Sounddateien werden im spezifischsten fonts/-, logos/- oder sounds/-Ordner gefunden, der sie enthält.
Regeln
- Jeder sichtbare Wert stammt aus Shot-Props oder Tokens. Keine hartcodierten Farben, Schriftarten, Größen in px ohne Prop oder Timings in Vorlagen.
- Projekte enthalten Daten, keinen Code. Ein neues Design ist eine Vorlage; ein neuer Auftrag ist ein Projekt mit Shot-Dateien.
- Setze einen Wert auf der niedrigsten Ebene, die ihn besitzt: ein Shot → Shot-Props; ein Projekt → Projekt
tokens.json; mehrere Projekte eines Kunden → eine Variante; der gesamte Kunde → Kunden-Tokens. - Niemals
tokens.lock.jsonvon Hand bearbeiten. Ausgelieferte Projekte sind eingefroren; sie ändern sich nur durchmg rebrand(siehemotion-render). - Nach jeder JSON- oder Vorlagenbearbeitung
pnpm mg checkausführen und die gemeldeten Fehler beheben, bevor gerendert wird. - Jede visuelle Änderung mit der
motion-qa-Prozedur abschließen, bevor sie als erledigt gemeldet wird. - Vor
mg rebrand --applyund vor der Bearbeitung von Kunden- oder Varianten-Tokens, die von eingefrorenen Projekten verwendet werden, den Benutzer fragen. - Wenn ein Rendering oder eine Doctor-Prüfung fehlschlägt, vor einer Code-Änderung
pnpm mg doctorausführen.
Routing
| Aufgabe | Lesen |
|---|---|
| Neuer Kunde, Variante, Logo, Schriftart, Farbpalette | motion-brand |
| Neues Projekt oder Shots aus einem Briefing; Text/Farben auf bestehenden Shots ändern | motion-project |
| Neue Vorlage oder eine Änderung der Animation einer Vorlage | motion-template, dann motion-style |
| Bewegungsgefühl: Easing, Timing, Staffelung, Sicherheitsbereiche | motion-style |
| Rendering, Voreinstellungen, Versionen, Auslieferung, Markenänderungen anwenden | motion-render |
| Ausgabe vor der Übergabe prüfen | motion-qa |
Befehle
pnpm mg templates Vorlagen-IDs auflisten
pnpm mg new-client|new-variant|new-project …
pnpm mg new-shot <kunde>/<projekt> <shot> --template <id> Shot-Datei mit allen Props auf Standardwerten
pnpm mg new-template <kunde> <name> Starter-Vorlage
pnpm mg check [<kunde> | <kunde>/<projekt>] alles ohne Rendering validieren
pnpm mg render <kunde>/<projekt> [shot…] überspringt unveränderte Shots; --force, --preset
pnpm mg still <kunde>/<projekt> [shot…] PNGs auf Schachbrettmuster ansehen (alle Shots standardmäßig)
PNpm mg studio <kunde>/<projekt> Live-Vorschau; Studio "Speichern" schreibt die Shot-Datei
pnpm mg deliver <kunde>/<projekt> rendern, verifizieren, einfrieren, Finales nach deliver/<datum>/ kopieren
pnpm mg rebrand <kunde | kunde/projekt> [--apply] Markenänderungen für ausgelieferte Arbeiten
pnpm mg freeze|unfreeze|diff <kunde>/<projekt>
pnpm mg doctor Umgebung, mg check, Smoke-Rendering