Remotion-Demo-Video-Fähigkeit
Diese Fähigkeit hilft beim Erstellen und Pflegen des Remotion-Demo-Videos unter:
demos/wallrun-video
Sie bietet Struktur für:
- Szenenerstellung
- Kompositionsstruktur
- wiederverwendbare Bewegungskomponenten
- Videotiming
- entwicklerorientierte Erklärungen
Diese Fähigkeit sollte verwendet werden, wenn du an folgenden Dingen arbeitest:
- Remotion-Kompositionen
- Szenenkomponenten
- animierte Erklärsegmente
- Videostruktur oder -sequenzierung
- Bewegungsprimitive, die von der Demo verwendet werden
Projektkontext
Dieses Repository ist ein Nx-Monorepo.
Das Remotion-Video befindet sich unter:
demos/wallrun-video
Das Projekt rendert ein entwicklerorientiertes Erklärvideo für WallRun.
Die Zielgruppe sind Frontend-Entwickler, nicht Marketingmitarbeiter.
Gehe davon aus, dass der Betrachter Folgendes versteht:
- React
- TypeScript
- Komponentenarchitektur
- Layoutsysteme
- Entwicklerwerkzeuge
Vermeide die Erklärung grundlegender JavaScript-Konzepte.
Designabsicht
Das Video sollte sich wie Entwickler-Medien anfühlen, nicht wie eine Produktwerbung.
Guter Ton:
- redaktionell
- minimalistisch
- modern
- selbstbewusst
- zurückhaltende Bewegung
Schlechter Ton:
- generischer SaaS-Werbespot
- kinoreife Trailer-Effekte
- schwere Partikelanimationen
- dichte Marketingtexte
Prioritäre:
- Lesbarkeit
- Hierarchie
- Tempo
- Klarheit
Projektstruktur
Der gesamte Code sollte sich in folgendem Verzeichnis befinden:
demos/wallrun-video/src
Struktur:
- components/ – Wiederverwendbare Präsentationsprimitive
- scenes/ – Zeitlich begrenzte Abschnitte des Videos
- data/ – Skript, Text, Timing-Konstanten
- Root.tsx – Registriert Kompositionen
- index.ts – Einstiegsdatei für die Remotion-CLI
Regeln für das Szenendesign
Jede Szene sollte nur eine Idee vermitteln.
Typische Dauer: 4–8 Sekunden
Szenen sollten:
- schnell lesbar sein
- große Typografie haben
- Überladung vermeiden
- Bewegung dezent halten
Bevorzugte Szenentypen:
- Titelkarten
- gestaffelte Repo-Screenshots
- Komponenten-Nahaufnahmen
- Callout-Overlays
- Architekturdiagramme
- Statistik-Panels
Vermeide:
- winzige Benutzeroberflächen
- lange Absätze
- übermäßig komplexe Übergänge
Animationsrichtlinien
Bevorzuge einfache, deterministische Animationen.
Beispiele:
- Einblenden
- Hochschieben
- gestaffelte Einblendung
- dezente Skalierung
Vermeide:
- Bounce-Effekte
- komplexe physikbasierte Bewegungen
- schwere Easing-Kurven
Das Ziel ist Klarheit, nicht Spektakel.
Codierungskonventionen
Verwende:
- React-Funktionskomponenten
- TypeScript
- benannte Exporte
- explizite Typen
- wiederverwendbare Bewegungswrapper
Vermeide:
- duplizierten Animationscode
- magische Zahlen
- hart codiertes Szenen-Timing
Extrahiere Timing-Konstanten, wenn möglich.
Beispiel:
const TITLE_FADE_IN = 20;
const CALLOUT_DELAY = 15;
Standard-Workflow für eine neue Szene
- Definiere die Botschaft der Szene
- Definiere die Dauer in Frames
- Gestalte das Layout
- Füge primäre Bewegung hinzu
- Füge sekundäre Bewegung nur hinzu, wenn sie die Klarheit verbessert
- Überprüfe die Lesbarkeit
- Stelle sicher, dass der Code wiederverwendbar ist
Nx-Targets
- preview –
nx preview wallrun-videoöffnet Remotion Studio - render –
nx render wallrun-videorendert das vollständige Video nachdist/demos/wallrun-video/ - type-check –
nx type-check wallrun-videoführt den TypeScript-Compiler aus
Definition of Done
Eine Szene ist fertig, wenn:
- die Botschaft sofort klar ist
- die Typografie im Videoformat lesbar ist
- die Animation zurückhaltend ist
- Timings einfach zu bearbeiten sind
- der Code sauber strukturiert ist