Communitygithub.com

DemoDay

Transforme un dépôt (GitHub ou dossier local) et son application web ou macOS native en une vidéo de démonstration professionnelle de 45 à 75 secondes en 1080p, avec storyboard, enregistrement scripté, zoom automatique, sous-titres et effets sonores, le tout stylisé pour correspondre à l'identité de l'application.

Qu'est-ce que DemoDay ?

DemoDay est un outil CLI Node/TS qui transforme un dépôt de code (GitHub ou local) accompagné de son application web ou macOS native en une vidéo de démonstration soignée de 45 à 75 secondes, en 1080p. Vous jouez le rôle de réalisateur : vous rédigez le storyboard (plan.json), et l'outil se charge de l'enregistrement et du rendu, sans nécessité de clé API. La vidéo est rendue avec Remotion et intègre des effets sonores synthétisés, des sous-titres, un zoom automatique sur chaque action, et un style visuel qui reprend les couleurs, polices et éléments graphiques de l'application cible. DemoDay est idéal pour les développeurs et chefs de produit souhaitant produire rapidement une vidéo de lancement ou de démonstration de leur produit, en s'appuyant sur le code source et l'application en direct. Il fonctionne sur macOS pour les applications natives et sur toute plateforme pour les applications web, et offre des fonctionnalités avancées comme la capture d'écran de l'application, l'enregistrement de frappes clavier et de clics souris, et la génération automatique de la bande-son.

Compatible avec✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/amoveablefeastym/demoday/tree/HEAD

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait DemoDay ?

Transforme un dépôt (GitHub ou dossier local) et son application web ou macOS native en une vidéo de démonstration de 45 à 75 secondes en 1080p, qui semble avoir été réalisée par le designer de l'application elle-même. L'outil est un CLI Node/TS fourni avec cette compétence. Vous êtes le réalisateur : vous écrivez le storyboard (plan.json) ; l'outil enregistre et effectue le rendu. Aucune clé API nécessaire.

0. Trouver et configurer l'outil (TOOL)

TOOL est le répertoire de base de cette compétence s'il contient package.json (l'installation normale : l'ensemble du dépôt cloné dans ~/.claude/skills/demoday). Sinon, il s'agit de ~/demoday. Si aucun des deux n'existe, arrêtez-vous et dirigez l'utilisateur vers les étapes d'installation dans le README.

Première exécution sur une machine (lorsque TOOL/node_modules est manquant) :

  1. Vérifiez node --version (nécessite ≥ 20). S'il est manquant, demandez à l'utilisateur d'installer Node.js (brew install node ou nodejs.org) et arrêtez-vous.
  2. Exécutez npm install && npx playwright install chromium dans TOOL. Cela télécharge environ 300 Mo, prévenez donc l'utilisateur avant de commencer.
  3. Pour une application Mac, vérifiez également xcrun swiftc --version. S'il est manquant, demandez à l'utilisateur d'exécuter xcode-select --install. L'assistant se compile lui-même lors de la première utilisation.

Toutes les commandes ci-dessous sont exécutées depuis TOOL. OUT = out/<propriétaire>__<dépôt> (affiché par l'outil). Les vidéos restent dans TOOL/out/, indiquez donc le chemin complet à l'utilisateur.

1. Rassembler

npx tsx src/cli.ts <propriétaire/dépôt ou url github> [--url <url app live>] --prepare

Nécessite une URL web active (--url, sinon la page d'accueil du dépôt) — ou, pour une application macOS native, voir « Applications Mac natives » ci-dessous. Cela lit le dépôt et sonde l'application, en écrivant dans OUT : prompt.md (règles du réalisateur + README + manifestes + arborescence des fichiers + instantané d'accessibilité), probe.png (capture d'écran du premier écran), probe.aria.yml.

Lisez prompt.md et examinez probe.png. Lisez src/schema.ts — c'est la structure exacte de plan.json, et les descriptions de ses champs sont des règles (limites de mots, ce que chaque beat doit faire).

2. Trouver l'histoire avant d'écrire quoi que ce soit

La vidéo repose sur deux éléments : pourquoi le statu quo est mauvais et ce qui rend ce produit spécial.

  • Statu quo : le workflow concret que l'utilisateur cible effectue aujourd'hui sans ce produit, avec un coût temporel honnête par étape. Seules des affirmations équitables concernant des concurrents nommés.
  • Spécial : le mécanisme qui rend cela possible (d'après le README/le code), pas des adjectifs. « Seul X … ».
  • Lisez le code pour les fonctionnalités que le README sous-estime : une icône de bureau ou de barre de menus toujours présente, un raccourci clavier global, un stockage hors ligne/local, une mascotte. Ce sont souvent les vrais différenciateurs. Vérifiez chaque fonctionnalité que vous revendiquez dans le code avant de la mettre dans la vidéo.
  • Si l'utilisateur vous a donné son positionnement, son concurrent ou son différenciateur, utilisez le leur. Si rien ne révèle ce qui le rend différent, posez une courte question avant d'écrire le plan.

3. Adapter le style de l'application (obligatoire)

La vidéo doit ressembler à une partie de l'application : mêmes couleurs, mêmes polices, même mascotte ou icône, même ton de voix. Un modèle de lancement sombre générique sur une application douce et pastel (ou vice versa) est perçu comme inapproprié. Les utilisateurs le remarquent immédiatement.

  1. Extrayez les tokens de design de l'application à partir du code :
    • SwiftUI/AppKit: un fichier de style Theme.swift, Assets.xcassets/*.colorset, des appels Color(hex:).
    • Web: propriétés CSS personnalisées, tailwind.config.*, fichiers de thème, <meta name="theme-color">.
    • Collectez : l'arrière-plan, le texte, la carte/panneau, l'accent, et les polices d'affichage/corps.
    • Polices : privilégiez les fichiers de polices regroupés dans le dépôt (Resources/Fonts/*.ttf, public/fonts, sources @font-face, next/font/local).
    • Mascotte/icône : sprites, l'icône de l'application (AppIcon.icns → sips -s format png … --out icon.png), ou le logo SVG/favicon.
  2. Choisissez l'ambiance à partir de l'interface de l'application, pas de sa catégorie. Utilisez mood: "soft" lorsque l'interface est légère, chaleureuse, ludique ou minimaliste. Utilisez bold (l'aspect sombre par défaut du lancement) lorsque l'application elle-même est sombre, technique ou à contraste élevé.
  3. Remplissez plan.look :
    "look": { "mood": "soft", "paper": "<bg app>", "ink": "<texte app>", "surface": "<carte app>",
              "fontFile": "<fichier police dépôt>", "bodyFontFile": "<optionnel>",
              "motifImage": "<png/svg icône/mascotte app>" }
    
    • Définissez product.accent sur l'accent de l'application, dans la nuance lisible sur paper. Les accents en mode clair sont généralement le bon choix pour le mode doux.
    • Le texte atténué et les lignes sont dérivés automatiquement de paper/ink.
    • Sans fichier de police, utilisez display (Inter Tight, Pixelify Sans, Fredoka, Nunito). Pour prendre en charge une autre police Google, ajoutez-la à DISPLAY dans remotion/lib.ts et à l'énumération du schéma.
    • motif: "loaf" est un sprite de pixel-loaf intégré (applications de boulangerie uniquement). Sinon, utilisez motifImage.
    • Le CLI copie ces fichiers dans OUT/brand/. Les chemins peuvent être absolus ou relatifs à un dépôt local.
  4. Adaptez la voix : empruntez la microcopie et les métaphores de l'application pour les sous-titres et les titres (par exemple, la « pâte / levée / cuisson » d'une application de boulangerie).
  5. Minimal par défaut :
    • Budget de copie : accroche ≤ 8 mots, environ 3 étapes de l'ancienne méthode, 3 lignes de comparaison, sous-titres de 2 à 5 mots, pas d'étiquettes ou de statistiques au-delà de l'essentiel.
    • Trop de mots et un style d'avertissement rouge bruyant ont été les principales plaintes. L'aspect doux supprime déjà les compteurs, les étiquettes de douleur, les secousses et les tampons.

4. Écrire OUT/plan.json

Suivez les règles du réalisateur en haut de prompt.md. Règles d'enregistrement (newWay.actions) :

  • Couvrez l'ensemble du cycle principal, pas seulement le chemin le plus court vers un résultat. Les utilisateurs remarquent quand les fonctionnalités phares sont absentes. Visez 10 à 20 actions (max 20), chaque fonctionnalité son propre beat sous-titré, effectuant le même travail que l'ancienne méthode et se terminant par le bénéfice. Web : la première action est goto vers l'URL live.
  • Sous-titrez presque chaque action. Un beat sans sous-titre est perçu comme un temps mort par un spectateur en mode silencieux.
  • Caméra : elle se rapproche de la zone cible de chaque action. Les actions fill/press non ciblées visent le champ qui a le focus. L'enregistreur enregistre sa position après l'envoi des touches, et les plans de frappe zooment à 2× sur le début du texte. Les sous-titres se trouvent dans leur propre bande en dessous de la fenêtre et ne couvrent jamais l'application. Si un plan cadre la mauvaise chose, corrigez la cible. Ne modifiez pas les boîtes manuellement.
  • Les sélecteurs proviennent de l'instantané. Préférez {role, name} copié textuellement (macOS : id, puis placeholder, puis role+name). Les entrées cachées dans les éditeurs de code sont correctes ; l'enregistreur clique sur leur conteneur visible.
  • Scénarisez les écrans plus profonds à partir d'instantanés réels, pas de suppositions :
    1. Écrivez un script jetable qui y navigue et se termine par un clic sur un id inexistant.
    2. Exécutez-le : mac/.build/macdriver run --app X.app --out <brouillon> --script s.json -- --demo <brouillon>/data. Le fichier est {"actions":[…]}. Web : une exécution --from plan.
    3. Lisez failures[].aria dans <brouillon>/events.json.
  • Saisie : les valeurs fill de plus de 80 caractères sont collées ; les plus courtes sont tapées visiblement. Utilisez des données réalistes, jamais « test ». Si des frappes disparaissent juste après un clic dans un nouveau champ (un titre tronqué, un champ vide, un clic ultérieur qui ne trouve pas le texte), divisez-le : click sur le champ, wait 500, puis fill non ciblé.
  • Bénéfice : exactement une action a emphasis: true. Placez-la sur un wait final (~2000ms) avec un sous-titre, juste après le clic qui la déclenche, pas sur le clic lui-même. La caméra recule alors pour montrer l'ensemble du résultat, et les attentes d'emphase se jouent en temps réel. Les autres longues attentes sont accélérées.
  • Beat de lanceur : si l'application vit sous la forme d'une icône toujours présente (bureau, barre de menus) ou derrière un raccourci clavier global, définissez plan.launcher (captions, hint optionnel tel que le raccourci clavier, badge optionnel).
    • La vidéo obtient alors un beat avant la démonstration : l'icône repose sur un bureau calme parmi des fenêtres floutées, le curseur clique dessus, et la vraie fenêtre en sort, atterrissant exactement là où commence la démonstration.
    • Il est composé dans Remotion (l'enregistreur ne capture que la fenêtre de l'application) et utilise motifImage/motif comme icône. Utilisez-le uniquement lorsque le code confirme le comportement.

5. Enregistrer + Rendre

npx tsx src/cli.ts <dépôt> --plan OUT/plan.json --from plan

Surveillez le journal : ✓ par action, ✗ avec l'erreur pour les échecs. En cas d'échec, lisez OUT/events.json → failures[] (chacun a l'instantané d'accessibilité au moment de l'échec), corrigez les cibles et relancez. Les actions échouées sont ignorées, pas fatales. Ne livrez pas une vidéo dont le bénéfice a échoué. Si une action précoce échoue, tout ce qui suit s'exécute généralement sur le mauvais écran : traitez tout l'enregistrement comme mauvais et regardez les trames de raw.mp4 pour voir ce qui s'est réellement passé.

Réexécution économique :

  • Modifications du code de copie, d'aspect, de lanceur, de son ou de scène : --from render, pas de réenregistrement.
  • Les sous-titres d'action sont intégrés dans events.json au moment de l'enregistrement. Corrigez-les là à partir de plan.json (par index), reconstruisez la timeline avec npx tsx -e 'import {editRecording} from "./src/edit.ts"; editRecording("OUT")', puis --from render.
  • Modifications d'étape : --from plan (réenregistre).

6. Vérifier avant de rapporter

Vérifiez le MP4 rendu, pas seulement les images fixes. Créez des planches contact et examinez chaque trame :

ffmpeg -v error -y -i OUT/demo.mp4 -vf "fps=1/2,scale=640:-1,tile=4x8" -frames:v 1 <brouillon>/sheet.jpg

Vérifiez :

  • Correspondance de style : mettez probe.png à côté des images fixes. Même famille d'arrière-plan, polices, accent et mascotte ? Si la vidéo ressemble à une marque différente, corrigez look avant toute autre chose.
  • Chaque valeur fill apparaît à l'écran exactement comme tapée. Un ✓ signifie seulement que l'action a été exécutée, pas que le texte a atterri.
  • La caméra est zoomée sur ce qui compte (le texte tapé, le contrôle cliqué), pas en plan large ou sur un canevas vide.
  • Les sous-titres sont lisibles et ne couvrent jamais l'application. Le texte tient ; rien ne déborde.
  • La trame « aha » montre le bénéfice (pas un état de chargement ou un bouton recadré).
  • Le beat de comparaison « X → Y » est crédible. Si le ratio est absurde, les secondes de l'ancienne méthode sont gonflées.
  • L'audio existe et les pics sont en dessous de 0 dB : ffmpeg -i OUT/demo.mp4 -af volumedetect -vn -f null -. Pour vérifier la synchronisation, dessinez un showwavespic d'un passage de frappe et comparez-le avec les trames.

7. Rapporter

Donnez à l'utilisateur :

  • le chemin vers OUT/demo.mp4 et sa durée
  • l'accroche, l'ancienne méthode et les lignes « seulement nous », une ligne chacune
  • comment l'aspect a été adapté (quelles couleurs, polices et mascotte proviennent de l'application)
  • tout ce que vous n'avez pas pu faire fonctionner, ou qui a été composé plutôt qu'enregistré (par exemple, le beat du lanceur)
  • tous les bogues que vous avez remarqués dans son application (par exemple, des frappes perdues)

Mentionnez la commande npx remotion studio … que l'outil affiche pour les réglages en direct, et --music <fichier> pour une bande sonore.

Effets sonores

Activés par défaut ; --no-sfx les désactive. scripts/make-sfx.py synthétise tout (pas d'échantillons, pas de licence) dans assets/sfx/, et remotion/Sfx.tsx synchronise chaque son avec les événements enregistrés :

  • Frappe : un son de commutateur mécanique tactile par caractère (clic de bosse, thock de fond, relâchement), à la vitesse de frappe réelle de l'enregistreur. Les espaces obtiennent un son stabilisé plus profond, Entrée un son plus lourd.
  • Clics : un clic de souris là où le curseur enregistré a cliqué, y compris le clic du lanceur.
  • Transitions : un whoosh à chaque changement de scène.
  • Ancienne méthode : un son d'atterrissage de carte par étape (pop en mode doux, thud en mode gras) et un son de verdict (pop doux, ou tampon en mode gras).
  • Bénéfice : un carillon.
  • Comparaison : un pop par ligne, et un carillon (doux) ou tampon (gras) sur le résultat temporel.

Avec --music, la musique est abaissée sous les effets. Modifiez les volumes dans Sfx.tsx et relancez --from render. Relancez le script après l'avoir modifié pour régénérer les WAV.

Applications Mac natives

Même flux, enregistreur différent (mac/macdriver.swift : API d'accessibilité pour trouver les contrôles, événements réels de souris/clavier, ScreenCaptureKit enregistre uniquement la fenêtre de l'application). Ajoutez --app et passez les arguments de lancement après -- :

npx tsx src/cli.ts <dépôt ou ./dossier/local> --app chemin/Vers.app [--app-seed demo/items.json] --prepare -- --demo {data}
  • {data} devient un nouveau dossier jetable par exécution, et --app-seed y est copié. N'enregistrez jamais avec les vraies données de l'utilisateur. Si l'application n'a pas de drapeau de lancement de répertoire de données/démo, ajoutez-en un (ou demandez à l'utilisateur) avant d'enregistrer. Reconstruisez d'abord l'application si l'utilisateur a des modifications non validées.
  • Exécutez mac/.build/macdriver check --open d'abord. Il nécessite les autorisations d'accessibilité et d'enregistrement d'écran et audio système pour l'application hébergeant le terminal. Si l'une ou l'autre manque, il ouvre le volet exact des Réglages Système et nomme l'application à activer (code de sortie 3). L'utilisateur doit redémarrer cette application après avoir accordé l'autorisation, ce qui met fin à cette session, arrêtez-vous et dites-lui de revenir plutôt que de réessayer. Sans enregistrement d'écran, --prepare fonctionne toujours, mais pas l'enregistrement. Rédigez le storyboard entre-temps pour qu'il soit prêt.
  • L'enregistrement prend le contrôle de la souris et du clavier réels de l'utilisateur (~20–60s, compte à rebours de 3s). Prévenez l'utilisateur juste avant chaque exécution, y compris les courtes exécutions de test. Ne commencez pas pendant qu'il pourrait taper : sa saisie vole le focus et gâche la prise.
  • Cibles : id, puis placeholder, puis role+name. Pas de goto. fill sans cible tape dans le champ actif. Utilisez press pour Entrée/Tab/Meta+N.
  • Les boutons d'icône sans étiquette sont invisibles pour l'automatisation. Si un contrôle clé n'a pas de nom et que vous possédez le code, ajoutez .accessibilityLabel/.accessibilityIdentifier.
  • N'interrogez pas l'arbre d'accessibilité pendant que les touches sont tapées. Dans les applications SwiftUI, une requête AX peut déclencher un nouveau rendu qui réinitialise un champ de texte à un texte obsolète, supprimant les frappes. Le pilote ne lit l'élément focalisé qu'après la frappe. Si vous modifiez le pilote, conservez cette approche. Si les frappes disparaissent encore, l'application a probablement ce bogue (une vue de texte NSViewRepresentable dont updateNSView écrase la chaîne avec une liaison obsolète). Informez l'utilisateur.

Limites

Les pages web derrière une connexion nécessitent que le flux commence à partir d'une page publique ou d'une URL pré-authentifiée. L'enregistrement natif est uniquement macOS et enregistre une seule fenêtre d'application. Tout ce qui se trouve à l'extérieur (bureau, barre de menus, autres applications) est composé dans Remotion, pas enregistré, donc mentionnez-le dans le rapport.

Skills associés