Communitygithub.com

scroll-narrative

À utiliser lorsqu'un site web, une page d'accueil, une page produit, un portfolio ou une étude de cas doit raconter une histoire plutôt que d'énumérer des blocs — scrollytelling, pages narratives, sites « cinématiques », pages chapitrées, timelines, parcours, avant/après, ou lorsque la page ressemble à un catalogue ennuyeux de sections.

Qu'est-ce que scroll-narrative ?

Cette compétence transforme n'importe quelle page web en une expérience narrative pilotée par le défilement (scrollytelling). Elle guide l'utilisateur (développeur ou designer) à travers un processus créatif en cinq étapes : trouver l'histoire sous-jacente, choisir un dispositif narratif (axe temporel, parcours, zoom, transformation, compte à rebours, personnage), rédiger un « beat sheet » (feuille de rythme), respecter des règles de rythme strictes, et construire la page avec les outils `storymotion.css` et `storymotion.js`. L'outil est particulièrement adapté aux marques, petites entreprises, voyages, lieux, artisanat, services avec résultats visibles, ainsi qu'aux pages « comment ça marche » pour SaaS. Il insiste sur le fait que chaque battement doit contenir une idée, un visuel et un mouvement, que le texte doit apparaître au moment qu'il décrit, et que la page doit être lisible même avec JavaScript désactivé. Une checklist finale garantit la qualité avant le déploiement.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YehorSS/storymotion/tree/main/skills/scroll-narrative

Demander à votre IA préférée

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

Documentation

Scroll Narrative

Tous les sites n'ont pas besoin d'une histoire. Décidez d'abord : une histoire complète (marques, petites entreprises, voyages, lieux, artisanat, services avec résultats visibles), une scène unique narrative (SaaS, applications : généralement « comment ça marche »), ou aucune (boutiques, documentations, tableaux de bord, formulaires : animation uniquement pour le feedback, utilisez web-motion seulement). Pour une partie, appliquez cette compétence à cette seule scène.

Un site narratif est une histoire que le visiteur parcourt avec la molette de défilement. Les faits sont tissés dans l'intrigue, pas empilés comme des blocs de fonctionnalités. L'animation (voir la compétence web-motion) est la façon dont le temps passe dans cette histoire.

1. Trouvez l'histoire avant tout code

Répondez en une ligne chacun :

  • Héros — qui ou quoi nous suivons (le visiteur, le produit, un lieu, un plat, une journée).
  • Désir — ce qu'il veut ou où il va.
  • Obstacle — ce qui se dresse sur le chemin (le problème que le produit résout).
  • Tournant — le moment où les choses changent (le produit, le sommet, la première bouchée).
  • Après — le monde après le tournant, et la seule action que le visiteur entreprend maintenant.

Choisissez ensuite un dispositif narratif qui structure tout le défilement :

DispositifDéfilement signifieBon pour
Axe temporelaube → nuit, 1920 → aujourd'hui, jour 1 → jour 30restaurants, événements, histoire, routines
Parcoursse déplacer le long d'une route ou d'une cartevoyages, logistique, expéditions, immobilier
Zoomville → rue → pièce → détailarchitecture, produits, artisanat
Transformationbrut → fini, avant → aprèsservices, rénovation, SaaS, fitness
Compte à reboursvers un lancement ou un moment culminantfestivals, sorties, lancements
Personnagesuivre la journée d'une personneapplications, services B2C

2. Rédigez la feuille de rythme (beat sheet)

Enregistrez sous beats.md avant de construire. Une ligne par battement :

#BattementTitre (≤ 8 mots)Corps (≤ 40 mots)Fait tisséVisuelAnimationLongueur de défilement

Arc standard (6–9 battements) :

  1. Accroche — le premier écran. En 3 secondes : de quoi il s'agit, le chiffre clé, l'action principale. Pas de « faites défiler pour découvrir » sans rien d'autre.
  2. Mise en place — le monde avant ; le héros et le désir.
  3. Voyage (2–4 battements) — progression à travers le dispositif ; chaque battement porte un fait comme point d'intrigue (« à 6 h du matin, le pain est déjà sorti — 140 pains »).
  4. Tournant — la plus grande scène : généralement une scène épinglée (200–300 vh) parcourue par le défilement.
  5. Preuve — chiffres, visages, avis, racontés comme le résultat de l'histoire.
  6. Résolution + CTA — là où l'histoire atterrit, et une action claire. Répétez l'action de l'accroche.

3. Règles de rythme

  • Une idée, un visuel, une animation par battement.
  • Alternez dense et aéré : après une scène épinglée, une photo calme en plein écran ou une seule phrase.
  • Au maximum ~3 scènes épinglées par page ; chaque épingle doit mériter sa longueur de défilement.
  • Page totale : 6–12 hauteurs de fenêtre sur desktop. Plus long seulement si chaque écran apporte encore du nouveau.
  • Le texte apparaît avec le moment qu'il décrit, jamais avant.
  • Le visiteur sait toujours où il se trouve : étiquette de chapitre + indicateur de progression.
  • Le défilement lui-même raconte l'histoire : l'indicateur utilise le dispositif narratif comme métaphore (heure, km, échelle, année, numéro de chapitre) et la palette et la typographie du site ; les chapitres y sont marqués et nommés au survol.

4. Contenu et réalisation

  • Les photos sont le protagoniste : uniquement haute résolution, nettes à 100 % de recadrage ; srcset réactif.
  • Écrivez comme une personne, mots simples ; pas de « libérez », « élevez », « sans couture ».
  • Les chiffres sont des points d'intrigue, pas une grille de statistiques — sauf si la grille est le point culminant.
  • Chaque battement doit survivre à la réduction d'animation et à l'absence de JS : il se lit toujours comme une bonne longue page.
  • Mobile n'est pas un desktop rétréci : épingles plus courtes (150–200 vh), scène empilée, typographie plus grande.

5. Construction

  1. Construisez sur storymotion.css + storymotion.js (dans web-motion/assets/ ; scènes épinglées avec --p, légendes d'étape, révélations, compteurs, étiquette de chapitre, indicateur de défilement déplaçable, chargeur, langues, réduction d'animation) et les recettes dans web-motion/references/recipes.md.
  2. Associez chaque battement à une section ; les battements épinglés deviennent .scene > .stage avec des légendes [data-step] ; la logique personnalisée par trame écoute l'événement progress de la scène.
  3. Ajoutez l'animation selon web-motion ; vérifiez à 375 px et 1440 px avec réduction d'animation activée et désactivée.

Liste de vérification avant la fin :

  • L'accroche réussit le test des 3 secondes.
  • Chaque battement a exactement un travail et un fait.
  • L'histoire se lit dans l'ordre avec JS désactivé.
  • L'étiquette de chapitre et l'indicateur correspondent à la feuille de rythme.
  • Le CTA à la fin répète l'action de l'accroche.

Skills associés