Style : Neon Node Explainer
Un explicatif technique calme : un titre par phrase, en dessous UN petit diagramme qui s'illumine pièce par pièce (fantôme estompé → allumé → ligne tracée → paquet défile → coche apparaît), puis coupe franche vers la phrase suivante.
Fiche : video-projects/_library/styles/neon-node-explainer/style.md — approuvé 2026-10-02.
Regardez d'abord (dans le dossier du style) : frames/01-chain-ai-mcp-apis.png · frames/02-hub-fanout-tools.png · frames/03-terminal-steps.png. Preuve que les couleurs suivent la marque : tests/2026-10-01-three-themes.jpg (pas dans le dépôt public).
0. Appliquez la fiche d'abord
node tools/vid.mjs style apply neon-node-explainer <projet> [--mode calm|punchy]
node tools/vid.mjs style show neon-node-explainer
Ensuite, lisez le README du kit : video-projects/_library/assets/kits/node-explainer/README.md (pièces, assistants, timing). Ne construisez pas à la main ce que le kit contient déjà.
1. Couleurs = rôles (la marque remplit le hex)
Style = qualité, structure et mouvement. N'expédiez jamais le violet / néon de référence sauf si la marque le demande.
Remplissez les rôles avec NX.theme(root, …) — le bloc "brandToNx" du README mappe les champs brand/<nom>.md :
| Jeton | Rôle | Depuis la marque |
|---|---|---|
--nx-bg | scène (mode clair bascule le kit en mode clair) | canevas |
--nx-surface / --nx-border | cartes, filets | surface / ligne |
--nx-text / --nx-dim | texte | texte-fort / atténué |
--nx-accent → --nx-accent-2 | 1 à 3 mots-clés du titre UNIQUEMENT | primaire → secondaire (identique = plat) |
--nx-role-1 | le modèle / "cerveau" | primaire |
--nx-role-2 | serveur / connecteur — lignes, paquets, arcs | info ou secondaire |
--nx-role-3 | systèmes / API | tertiaire ou une teinte de primaire |
--nx-role-4 | l'application / client | surface ou blanc |
--nx-ok / --nx-warn / --nx-danger | statut (warn = chemin surligné aussi) | succès / avertissement / danger |
Thèmes sauvegardés : neon (référence — tests uniquement), midnight, light (palettes d'exemple fictives, pas de vraies marques). Tout le reste est dérivé — ne définissez jamais de couleurs dérivées par marque. Une couleur = un rôle pour toute la vidéo ; moins de couleurs de marque → réutilisez une teinte de primaire, n'inventez pas de teinte. |
2. Construisez-le
- Partez d'un bloc de démonstration (copie
nx.css,nx.js, GSAP, DrawSVG, polices, 2 sons d'interface) :Reliez lenode tools/vid.mjs use node-explainer-9x16 <projet> # _library/compositions/portrait/node-explainer-9x16.html (20 s, 5 scènes) node tools/vid.mjs use node-explainer-16x9 <projet> # _library/compositions/node-explainer-16x9.html (20.5 s, 6 scènes)<div … data-composition-src=…>imprimé dansindex.htmlavecdata-variable-values='{"theme":"<marque>"}'. Rendu de démonstration à comparer :_library/styles/neon-node-explainer/tests/demo-9x16-20261001.mp4 (pas dans le dépôt public),demo-16x9-20261001.mp4. - Disposition 9:16 (1080×1920) : titre en haut (78 px, max 2 lignes,
text-wrap: balance), un diagramme centré en dessous ; tout à l'intérieur de x 60–960, y 220–1500. - Disposition 16:9 (1920×1080) : titre 66 px en haut, diagramme centré ; les scènes docs + curseur, piste et fractionnées sont dans le bloc 16:9.
- Scènes :
NX.scene(tl, el, in, out)= coupe franche ·NX.headline= entier sur l'image de coupe · puisNX.ignite/NX.draw/NX.packet/NX.check/NX.chip/NX.pill+NX.type/NX.term/NX.steps/NX.fanout/NX.cursor. Chaque assistant ajoute au moment que vous passez et renvoie son heure de fin. - Jetons de mouvement (JSON de la fiche) : fantôme 0,1 s · allumage 0,22 s · ligne 0,35 s · paquet 0,32 s (10 % de la ligne) · pop 0,3 s back.out(1,7) · construction des étapes espacées de 0,4 à 1,2 s sur la voix · maintenir le diagramme fini 0,5 à 1,5 s · frappe 25 car/s (latin uniquement).
- Texte : titre instantané sur la coupe (pas de fondu, pas de fractionnement de lettres) · étiquettes mono en majuscules tapées · lignes de terminal tapées, sortie glissée de 10 px.
- Transitions : coupe franche uniquement ; canevas vide 0,1–0,3 s, puis la construction.
- Modes : calme = titre toutes les ~4 s, pas d'effets sonores, lueur 0,35 · percutant = toutes les ~2,5–3 s, tic à chaque pièce allumée, lueur 0,5, paquet défile deux fois.
- Son : voix-off en premier plan (−14 LUFS). Effets sonores optionnels
_library/assets/sfx/gen/ui-tick.wav (pas dans le dépôt public)(pièce allumée) etui-pop.wav(coche / clic) à 0,22 / 0,28 en tant que balises<audio>statiques. Fond sonore uniquement si nécessaire : un pad calme de_librarymusique à environ −24 LUFS. Ne générez jamais de musique.
3. Vérifications avant que le propriétaire ne voie le résultat
npx hyperframes lintdans le projet — 0 erreurs.npx hyperframes snapshot --at <fin de chaque construction>— Lisez chaque image : un diagramme par titre, rien hors rôle.npx hyperframes render --quality draft→node tools/vid.mjs judge <draft.mp4>→ Lisezsheet.jpgetsafe-sheet.jpg.- Zone de sécurité x 60–960, y 220–1500 (9:16). Titre arabe attaché et de droite à gauche, mots anglais dans des balises
.nx-ltr, jamais tapés, jamais fractionnés par lettre, pas dedir="rtl"sur<html>. - Vérifications de style : l'image de couverture (t=0) montre déjà une pièce allumée (une couverture entièrement noire échoue au juge) ; accent uniquement sur 1 à 3 mots-clés ; lueur uniquement sur la pièce active.
À faire / À ne pas faire
- À faire : un titre par phrase parlée et construisez uniquement ce qu'elle dit ; étiquettes anglaises mono majuscules, titres arabes ; commencez chaque scène avec une pièce visible ou un fantôme ; laissez la lueur signifier "actif".
- À ne pas faire : expédier le violet de référence sur une marque qui ne l'utilise pas ; deux diagrammes sous un même titre ; lueur d'arrière-plan, points ou grain ; taper en arabe ; faire passer le terminal / la liste d'outils pour une véritable interface utilisateur de produit.
Après le travail : node tools/vid.mjs style comment neon-node-explainer "<ce qui a fonctionné ou non>".