Bande démo Flutter
Construisez une courte promo en boucle pour une application Flutter sous la forme d'une application macOS Flutter autonome dans <flutter app>/demo, rendez-la image par image hors ligne et encodez-la. La bande utilise les écrans réels de l'application, ses illustrations, ses polices et son contenu, une couche 3D avec flutter_scene (Flutter GPU sur Metal), un kit 2D de particules et de titres, et des coupures synchronisées sur la musique.
Les chemins ci-dessous sont relatifs au dossier de ce skill (le dossier contenant ce SKILL.md). Dans Claude Code, ce dossier est ${CLAUDE_SKILL_DIR}.
Règles de base
- Ne modifiez jamais l'application. Copiez ce dont vous avez besoin (illustrations, polices, captures d'écran, données de contenu, couleurs du thème) dans
demo/. Le scaffold ajoute uniquementdemo/**aux exclusions de l'analyseur du paquet parent. - Chaque image est une fonction pure de
t. Pas d'état entre les images, pas deRandom(), pas d'horloges, pas de simulation : mouvement en forme fermée, aléatoire ensemencé. C'est ce qui permet le défilement, l'export par lots, le flou de mouvement et une boucle sans couture. Lisez references/kit.md avant d'écrire des plans. - Suivez les règles de voix du projet (AGENTS.md, CLAUDE.md ou similaire) : mots que l'application n'utilise jamais, comment le produit se nomme, ton.
- Acceptez avant de construire. Interviewez l'utilisateur, puis rédigez un script qu'il approuve.
- macOS uniquement. Nécessite Flutter avec macOS Desktop, ffmpeg (
brew install ffmpeg), et Python 3 avec Pillow (planches contact) et numpy (analyse audio).
Flux de travail
1. Interview
Demandez avant de commencer, en proposant une valeur par défaut pour chaque point afin que l'utilisateur puisse répondre rapidement :
- Durée et boucle (par défaut 30 s, boucle transparente), formats (paysage 1920x1080 et portrait 1080x1920, portrait conçu pour Reels, TikTok et Shorts), 60 ips.
- Bande-son : un fichier (avec paroles ?) ou aucun, et qui en possède les droits.
- Le message : les 3 à 5 choses à montrer, l'appel à l'action (URL, badges de l'app store), les affirmations à faire (gratuit ? notes ? comptes ?).
- Aspect et ton : jusqu'où aller, la marque de l'application, toute référence.
- Écrans réels : lesquels, et pouvez-vous exécuter l'application pour les capturer (compte de test, données amorcées) ? Des plans atmosphériques inventés aussi ?
- Texte à l'écran : mots-clés uniquement (par défaut) ou légendes complètes, orthographe du nom du produit, mots à éviter.
- Quelque chose de spécial : œufs de Pâques, personnages, choses à ne jamais montrer.
2. Étudier l'application
Lisez le thème de l'application (couleurs, polices), les ressources (logos, personnages, icônes), le contenu (vrais noms, chiffres, données à afficher) et ses écrans principaux. Notez ce qui la rend distinctive. Planifiez les captures d'écran et capturez-les, ou demandez-les à l'utilisateur (voir « Captures d'écran réelles » dans references/craft.md).
3. Analyser la bande-son
python3 scripts/analyze_audio.py <track>
Transformez son tempo, sa phase de battement, ses sections et ses lignes vocales en repères nommés, comme dans references/audio-sync.md. Sans bande-son, choisissez quand même un tempo et coupez sur sa grille.
4. Rédiger le script
Créez un tableau minuté avec, pour chaque plan : la musique ou la parole, l'image paysage, l'image portrait et le texte à l'écran (modèle dans references/craft.md). Marquez l'accroche, le drop, la carte de fin et la jointure de boucle. Obtenez l'approbation de l'utilisateur et itérez jusqu'à ce qu'il donne son feu vert.
5. Initialiser
zsh scripts/scaffold.sh <chemin de l'app Flutter>
Exécutez-le avec le chemin complet vers le dossier scripts/ de ce skill ; il fonctionne depuis n'importe quel répertoire. Il :
- crée
<app>/demoavecflutter create --platforms macos; - ajoute flutter_scene, vector_math et audioplayers, et exécute
flutter_scene:init; - active Flutter GPU (
FLTEnableFlutterGPU) et désactive le bac à sable de l'application (l'exportateur exécute ffmpeg) ; - copie le kit de démarrage depuis
assets/template/, créeart/,art/screens/,audio/etfonts/, et ignoreout/; - exclut
demo/**de l'analyseur du paquet parent.
Il fonctionne avec les espaces de travail pub (la démo reste un paquet autonome) et refuse d'écraser un dossier existant.
Configurez ensuite :
lib/core/timeline.dart:kDuration,kBpm,kBeatPhaseet lesCues.lib/core/format.dart:Palettedepuis le thème de l'application, etFonts(copiez les fichiers de polices dansdemo/fonts/et déclarez-les danspubspec.yaml).- Ressources :
art/(listez les sous-dossiers danspubspec.yaml) etaudio/track.wav(48 kHz PCM).
Compilez une fois et rendez les images de test pour prouver que la configuration fonctionne :
cd <app>/demo && flutter build macos --profile && tool/run.sh stills "0.3,2.3,9" both
6. Construire la bande
Remplacez lib/shots/example.dart par une section par partie du script, listez-les dans Director.sections et définissez les hits de caméra dans Director._hits. Travaillez section par section :
- Écrivez la section (image 3D, et couches 2D en dessous et au-dessus) en utilisant le kit (references/kit.md) et flutter_scene (references/flutter-scene.md).
- Exécutez
flutter build macos --profile, puis rendez les images aux moments clés de la section dans les deux formats :tool/run.sh stills "t1,t2,..." both. - Réalisez une planche contact par format et inspectez-la, ainsi que des images individuelles en gros plan là où le détail compte :
python3 tool/sheet.py out/l.png 4 480 out/stills/landscape_*.png. Si vous ne pouvez pas visualiser les images, dites à l'utilisateur quelles images vérifier et quoi regarder. Corrigez et répétez.
Passez en revue la liste de vérification dans references/craft.md sur l'ensemble de la bande avant l'exportation. L'utilisateur peut la visionner avec la musique dans l'application de prévisualisation (open build/macos/Build/Products/Profile/*.app) ; les images ne peuvent pas montrer le timing.
7. Exporter
tool/export.sh draft both # 1x, sans flou de mouvement : vérification rapide complète
tool/export.sh final both # 2x suréchantillonné, flou de mouvement sur 4 échantillons
Un export final prend environ 10 à 15 minutes par format pour 30 s. Lancez-le en arrière-plan si votre environnement le permet, et ne le sondez pas. Ensuite, vérifiez les fichiers avec ffprobe : le nombre d'images est kDuration * kFps, la durée est correcte et il y a un flux audio. Extrayez quelques images des MP4, y compris la dernière image et l'image 0 (la jointure de boucle).
8. Livrer et itérer
Donnez à l'utilisateur les chemins (demo/out/final/<format>.mp4 pour l'upload, <format>_master.mov ProRes pour le montage), les tailles de fichiers et ce qu'il doit vérifier. Attendez-vous à des commentaires. Les plus courants, avec leurs correctifs, se trouvent dans references/craft.md : texte affiché trop brièvement, texte masqué, sous-titres indésirables, coutures dans les contours, rayons lumineux durs, un ensemble d'éléments identiques, formulation portrait. Corrigez tous les commentaires en une session avant de relancer le rendu.
Fichiers
- references/kit.md : architecture et API du kit de démarrage.
- references/flutter-scene.md : configuration, apparence et pièges hors ligne de flutter_scene.
- references/audio-sync.md : tempo, phase, paroles et repères à partir d'une piste.
- references/craft.md : modèle de script, règles de texte, recettes d'effets, captures d'écran, liste de vérification.
scripts/scaffold.sh: crée l'application démo.scripts/analyze_audio.py: tempo, phase de battement, volume par mesure, attaques.assets/template/: kit de démarrage copié par le scaffold.