Flutter Demo Reel
Baue ein kurzes, sich wiederholendes Promo-Video für eine Flutter-App als eigene macOS-Flutter-App im Ordner <flutter app>/demo, rendere es offline Bild für Bild und kodiere es. Der Reel verwendet die echten Screens, Grafiken, Schriftarten und Inhalte der App, eine 3D-Ebene auf flutter_scene (Flutter GPU auf Metal), ein 2D-Partikel- und Titel-Kit und Schnitte auf die Musik.
Die Pfade unten beziehen sich auf den Ordner dieses Skills (den Ordner, der diese SKILL.md enthält). In Claude Code ist dieser Ordner ${CLAUDE_SKILL_DIR}.
Grundregeln
- Ändere niemals die App. Kopiere, was du brauchst (Grafiken, Schriftarten, Screenshots, Inhaltsdaten, Theme-Farben) in
demo/. Das Grundgerüst fügt nurdemo/**zu den Analyzer-Ausschlüssen des übergeordneten Pakets hinzu. - Jeder Frame ist eine reine Funktion von
t. Kein Zustand zwischen Frames, keinRandom(), keine Uhren, keine Simulation: geschlossene Bewegungsformeln, gesetzte Zufälligkeit. Das macht Scrubbing, chunked Export, Bewegungsunschärfe und einen nahtlosen Loop möglich. Lies references/kit.md, bevor du Shots schreibst. - Befolge die Stimmregeln des Projekts (AGENTS.md, CLAUDE.md oder ähnlich): Wörter, die die App nie verwendet, wie sich das Produkt selbst nennt, Ton.
- Vereinbare vor dem Bauen. Befrage den Nutzer, schreibe dann ein Drehbuch, das er genehmigt.
- Nur macOS. Benötigt Flutter mit macOS Desktop, ffmpeg (
brew install ffmpeg) und Python 3 mit Pillow (Kontaktbögen) und numpy (Audioanalyse).
Arbeitsablauf
1. Befragung
Frage, bevor du beginnst, und gib jeweils einen Standardwert an, damit der Nutzer schnell antworten kann:
- Länge und Loop (Standard 30 s, nahtloser Loop), Formate (Landscape 1920x1080 und Portrait 1080x1920, Portrait für Reels, TikTok und Shorts konzipiert), 60 fps.
- Soundtrack: eine Datei (mit Text?) oder keine, und wem die Rechte gehören.
- Die Botschaft: die 3–5 Dinge, die gezeigt werden sollen, der Handlungsaufruf (URL, Store-Badges), Behauptungen (kostenlos? Bewertungen? Zählungen?).
- Look und Ton: wie übertrieben, die Marke der App, etwaige Referenzen.
- Echte Screens: welche und darfst du die App ausführen, um sie zu erfassen (Testkonto, vorgegebene Daten)? Auch erfundene Atmosphären-Shots?
- Text auf dem Bildschirm: nur Schlüsselwörter (Standard) oder vollständige Untertitel, Schreibweise des Produktnamens, zu vermeidende Wörter.
- Etwas Besonderes: Easter Eggs, Charaktere, Dinge, die niemals gezeigt werden sollen.
2. App studieren
Lies das Theme der App (Farben, Schriften), Assets (Logos, Charaktere, Icons), Inhalte (echte Namen, Zahlen, anzuzeigende Daten) und ihre Hauptbildschirme. Notiere, was sie auszeichnet. Plane die Screenshots und erfasse sie oder bitte den Nutzer darum (siehe „Echte Screenshots“ in references/craft.md).
3. Soundtrack analysieren
python3 scripts/analyze_audio.py <track>
Wandle sein Tempo, seine Beat-Phase, seine Abschnitte und Gesangslinien in benannte Cues um, wie in references/audio-sync.md. Ohne Soundtrack wähle trotzdem ein Tempo und schneide auf dessen Raster.
4. Drehbuch schreiben
Erstelle eine zeitgesteuerte Tabelle mit für jeden Shot: die Musik oder den Text, das Landscape-Bild, das Portrait-Bild und den Text auf dem Bildschirm (Vorlage in references/craft.md). Markiere den Hook, den Drop, die Endcard und die Loop-Naht. Hole die Zustimmung des Nutzers ein und iteriere, bis er grünes Licht gibt.
5. Grundgerüst erstellen
zsh scripts/scaffold.sh <flutter app dir>
Führe es mit dem vollständigen Pfad zum scripts/-Ordner dieses Skills aus; es funktioniert von jedem Verzeichnis aus. Es:
- erstellt
<app>/demomitflutter create --platforms macos; - fügt flutter_scene, vector_math und audioplayers hinzu und führt
flutter_scene:initaus; - aktiviert Flutter GPU (
FLTEnableFlutterGPU) und schaltet die App-Sandbox aus (der Exporter führt ffmpeg aus); - kopiert das Starter-Kit aus
assets/template/, erstelltart/,art/screens/,audio/undfonts/und ignoriertout/; - schließt
demo/**vom Analyzer des übergeordneten Pakets aus.
Es funktioniert in Pub Workspaces (das Demo bleibt ein eigenständiges Paket) und weigert sich, einen vorhandenen Ordner zu überschreiben.
Konfiguriere dann:
lib/core/timeline.dart:kDuration,kBpm,kBeatPhaseund dieCues.lib/core/format.dart:Paletteaus dem Theme der App undFonts(kopiere die Schriftartdateien indemo/fonts/und deklariere sie inpubspec.yaml).- Assets:
art/(Unterordner inpubspec.yamlauflisten) undaudio/track.wav(48 kHz PCM).
Baue einmal und rendere die Beispiel-Stills, um zu beweisen, dass das Setup funktioniert:
cd <app>/demo && flutter build macos --profile && tool/run.sh stills "0.3,2.3,9" both
6. Reel bauen
Ersetze lib/shots/example.dart durch einen Abschnitt pro Teil des Drehbuchs, liste sie in Director.sections auf und setze die Kamera-Treffer in Director._hits. Arbeite Abschnitt für Abschnitt:
- Schreibe den Abschnitt (3D-Frame und 2D-Layer darunter und darüber) mit dem Kit (references/kit.md) und flutter_scene (references/flutter-scene.md).
- Führe
flutter build macos --profileaus, rendere dann Stills zu den Schlüsselmomenten des Abschnitts in beiden Formaten:tool/run.sh stills "t1,t2,..." both. - Erstelle einen Kontaktbogen pro Format und überprüfe ihn, plus einzelne Stills aus der Nähe, wo Details wichtig sind:
python3 tool/sheet.py out/l.png 4 480 out/stills/landscape_*.png. Wenn du Bilder nicht ansehen kannst, teile dem Nutzer mit, welche Stills er überprüfen und worauf er achten soll. Behebe es und wiederhole.
Führe die Überprüfungs-Checkliste in references/craft.md für den gesamten Reel durch, bevor du exportierst. Der Nutzer kann ihn mit der Musik in der Vorschau-App ansehen (open build/macos/Build/Products/Profile/*.app); Stills können Timing nicht zeigen.
7. Exportieren
tool/export.sh draft both # 1x, keine Bewegungsunschärfe: eine schnelle vollständige Überprüfung
tool/export.sh final both # 2x supersampled, 4-Sample Bewegungsunschärfe
Ein finaler Export dauert etwa 10–15 Minuten pro Format für 30 s. Führe ihn im Hintergrund aus, wenn deine Umgebung das zulässt, und poll ihn nicht. Überprüfe danach die Dateien mit ffprobe: die Bildanzahl ist kDuration * kFps, die Dauer stimmt und es gibt einen Audiostream. Ziehe ein paar Frames aus den MP4s, einschließlich des letzten Frames und Frame 0 (der Loop-Naht).
8. Liefern und iterieren
Gib dem Nutzer die Pfade (demo/out/final/<format>.mp4 zum Hochladen, <format>_master.mov ProRes zum Bearbeiten), die Dateigrößen und was zu überprüfen ist. Erwarte Anmerkungen. Typische, mit Korrekturen, findest du in references/craft.md: Text zu kurz gehalten, Text verdeckt, unerwünschte Untertitel, Nähte in Umrissen, harte Lichtstrahlen, eine Reihe von Elementen, die gleich aussehen, Portrait-Formulierung. Behebe alle Anmerkungen in einem Durchgang, bevor du neu renderst.
Dateien
- references/kit.md: Architektur und APIs des Starter-Kits.
- references/flutter-scene.md: Einrichtung von flutter_scene, Look und Offline-Fallstricke.
- references/audio-sync.md: Tempo, Phase, Text und Cues aus einem Track.
- references/craft.md: Drehbuch-Vorlage, Textregeln, Effekt-Rezepte, Screenshots, die Überprüfungs-Checkliste.
scripts/scaffold.sh: Erstellt die Demo-App.scripts/analyze_audio.py: Tempo, Beat-Phase, Lautstärke pro Takt, Einsätze.assets/template/: Das Starter-Kit, das das Grundgerüst kopiert.