Page d'accueil à défilement parallaxe
Transformez une courte vidéo en une page d'accueil cinématographique sur un seul écran. Le défilement de l'utilisateur pilote la vidéo image par image, tandis que cinq scènes de texte dramatiques s'estompent en entrée et en sortie. Le document ne défile jamais vraiment : les entrées souris, tactiles et clavier sont interceptées en JavaScript et converties en une progression virtuelle des images.
Cette compétence encapsule les modèles éprouvés dans la référence fournie avec ../../examples/parasites/ (les pages github / lion / hope — trois pages fonctionnelles construites avec cette compétence). Considérez ce dossier comme la vérité ultime en cas d'ambiguïté.
Place de cette compétence dans la pyramide YUV.AI
parallax-landing-page se situe dans le niveau intermédiaire de la pyramide des compétences YUV.AI, aux côtés de yuv-design-system, yuv-decks, yuv-viral-video et video-to-landing-page. L'orchestrateur de niveau supérieur yuv-pilot achemine les requêtes ici dès qu'un clip de 5 à 15 secondes doit devenir une page d'accueil monobloc à défilement piloté par le défilement.
Cette compétence apporte son propre langage visuel (Anton + Caveat + Inter, palette or/ambre/accent/crème) — elle n'appelle PAS yuv-design-system. Les deux systèmes coexistent : yuv-design-system possède la palette de marque sur les surfaces web/app/présentations ; parallax-landing-page possède l'esthétique cinématographique de défilement piloté. Pour les pages d'accueil à parallaxe YUV.AI, vous pouvez OPTIONNELLEMENT ajouter un filigrane phénix + l'URL canonique Linktree dans le pied de page comme fil conducteur de marque — voir yuv-design-system/assets/ pour le fichier du filigrane. Ne remplacez PAS la pile de polices Anton/Caveat par la palette Neon du système de design — cela ferait perdre le look signature.
Ce que vous construisez
Chaque page d'accueil est une fenêtre d'affichage verrouillée unique avec :
- Un canevas remplissant l'écran, dessinant une image à la fois (cover-fit, DPR ≤ 2)
- 5 scènes de texte positionnées en absolu (accroche + titre Anton majuscule + ligne manuscrite Caveat), chacune avec sa propre fenêtre de progression du défilement
- Une navigation fixe avec le logo
PARALLAX // showcaseet des liens vers les pages d'accueil sœurs - Un chargeur qui précharge chaque image avant de laisser l'utilisateur interagir
- Une superposition de vignette + grain de film
- Un indice de défilement en bas qui disparaît une fois que l'utilisateur commence à défiler
- Un compteur d'images en bas à droite (par ex.
073 / 145) - Une scène finale qui est la section d'appel à l'action — pas de section
.endséparée en dessous
Poids total à q:v 2 : environ 120–220 Ko par image × nombre d'images. Un clip de 6 secondes à 24 i/s = 145 images ≈ 25 Mo. Un clip de 10 secondes = 241 images ≈ 53 Mo.
Emplacement de sauvegarde
Par défaut : ~/Documents/yuv-projects/landings/<slug>/ — sauvegardez toujours les pages d'accueil autonomes ici pour pouvoir les retrouver. Remplacez uniquement si l'utilisateur choisit explicitement un autre emplacement OU si le mode B (intégration dans la galerie examples/parasites/ existante) est sélectionné.
mkdir -p ~/Documents/yuv-projects/landings
cd ~/Documents/yuv-projects/landings
# La compétence crée <slug>/ ici pendant l'extraction des images et la construction du HTML.
Chemin final (mode A — autonome) : ~/Documents/yuv-projects/landings/<slug>/.
Chemin final (mode B — intégration) : le répertoire de la galerie existante choisi par l'utilisateur.
Informez l'utilisateur du chemin final à la fin de chaque construction.
Processus de travail
Il y a quatre phases. Ne sautez pas de phases — chacune alimente la suivante.
Phase 1 — Découverte
Confirmez avec l'utilisateur :
- Chemin de la vidéo — où se trouve le fichier MP4 source.
- Slug — nom court du dossier/fichier (ex.
hope,marcus,desk). Un mot, minuscules, sans espaces. Il devient à la fois le nom du dossier d'images (<slug>/) et le nom du fichier HTML (<slug>.html). - Thème / sujet — de quoi parle cette page d'accueil ? Un lancement de produit ? Un moment personnel ? Une rencontre animalière ? Vous en avez besoin pour rédiger le texte.
- Mode de projet — autonome (nouveau dossier) ou intégration dans la galerie parasites existante à
examples/parasites/(en haut de ce dépôt). Si l'utilisateur dit "ajoute-le à la galerie", cela signifie le mode B ci-dessous. - Couleur d'accent — pour la mise en évidence du script/CTA :
gold(#f5b042),amber(#ff8a3d),accent(rose #ff4d6d),cream(#f5e9d4), ou une nouvelle (ajoutez-la dans:rootde style.css et créez une nouvelle règle.script.<nom>).
Si l'utilisateur n'a pas spécifié certains de ces éléments, proposez des valeurs par défaut et passez à la suite — ne restez pas bloqué sur des questions qu'il pourra décider en voyant le résultat.
Phase 2 — Extraction des images
Exécutez le script d'extraction fourni. Il sonde la vidéo avec ffprobe et extrait chaque image en résolution native avec -q:v 2 (JPEG quasi sans perte), en les nommant frame-001.jpg à frame-NNN.jpg (complétées par des zéros sur 3 chiffres).
python <skill>/scripts/extract_frames.py <video_path> <output_folder>
Exemple :
python C:/Users/User/.claude/skills/parallax-landing-page/scripts/extract_frames.py \
C:/Users/User/Documents/parasites/hope/hope.mp4 \
C:/Users/User/Documents/parasites/hope
Le script imprime un bloc de métadonnées JSON sur stdout. Capturez-le — vous avez besoin de frame_count et suggested_scroll_budget pour le HTML.
Pourquoi -q:v 2 : ezgif et outils similaires recompressent agressivement (~55 Ko/image). FFmpeg natif à q:v 2 donne ~120–220 Ko/image aux mêmes dimensions — visiblement plus net. Ne réduisez pas la résolution ; n'augmentez jamais la résolution (cela gonfle les fichiers sans ajouter de détails).
Pourquoi la formule du budget de défilement (≈26 px par image) : elle maintient la sensation tactile de "pixels de défilement par image avancée" constante quelle que soit la longueur du clip. 145 images → ~4200, 241 images → ~6300, 90 images → ~2500 (plancher). Le script le calcule pour vous et le limite à [2500, 8000].
Phase 3 — Création de la page
Lisez le modèle à <skill>/assets/landing-page-template.html. C'est un fichier fonctionnel complet avec des marqueurs {{PLACEHOLDER}} et des commentaires <!-- TODO: --> à côté des parties créatives. Créez un nouveau fichier à <target>/<slug>.html avec toutes les substitutions effectuées.
Liste de vérification des substitutions (chaque espace réservé doit être remplacé) :
| Espace réservé | Ce qu'il faut mettre | Exemple |
|---|---|---|
{{PAGE_TITLE}} | Balise HTML <title> | Hope — Le cœur le plus rapide du Néguev |
{{PAGE_DESCRIPTION}} | Balise meta description, une phrase | Un instant avec Hope, le guépard de Midbarium. |
{{SLUG}} | Nom du dossier (sans chemin, sans barre oblique) | hope |
{{FRAME_COUNT}} | Nombre entier d'images | 241 |
{{FRAME_COUNTER_TEXT}} | 001 / NNN avec la largeur correspondante | 001 / 241 |
{{SCROLL_BUDGET}} | Nombre entier issu du JSON de l'extracteur | 6300 |
{{PREVIEW_FRAME_MID}} | Image du milieu complétée par des zéros | 121 |
{{PREVIEW_FRAME_END}} | Dernière image complétée par des zéros | 241 |
{{LOADER_TITLE}} | Un mot, en majuscules | HOPE |
{{LOADER_SCRIPT}} | Ligne manuscrite se terminant par … | invoquant le coureur… |
{{NAV_LINKS_HTML}} | Bloc complet de balises <a> pour la navigation | voir ci-dessous |
{{SCENE_N_*}} | Accroche, titre, ligne manuscrite pour chacune des 5 scènes | voir guide de rédaction |
{{SCROLL_HINT_TEXT}} | Invite de 2 à 4 mots en majuscules | DÉFILEZ POUR COURIR |
{{CTA_BUTTONS_HTML}} | 2 à 4 balises <a class="cta"> | voir ci-dessous |
{{ACCENT_CLASS}} | Suffixe de couleur d'accent pour .script.X et .cta.X | amber |
Consultez references/copy-guide.md pour les modèles de texte cinématographique (phrasé de l'accroche, longueur du titre, ton de la ligne manuscrite). Le texte est ce qui donne sa valeur à cette compétence — un texte générique ruinera une animation par ailleurs magnifique.
Phase 4 — Raccordement des ressources
Si le dossier cible contient déjà style.css et parallax.js (intégration dans une galerie), ne faites rien — ils sont partagés. Sinon, copiez les deux depuis <skill>/assets/ vers le dossier cible :
cp <skill>/assets/style.css <target>/style.css
cp <skill>/assets/parallax.js <target>/parallax.js
Si vous intégrez dans une galerie existante, suivez également les étapes dans references/showcase-integration.md — ajoutez une carte à index.html, ajoutez un lien vers chaque page d'accueil existante dans la barre de navigation, et enchaînez l'appel à l'action de la page d'accueil précédente sur sa scène finale.
Indiquez à l'utilisateur comment visualiser :
Ouvrir
<target>/<slug>.htmlviapython -m http.server 8000depuis le dossier parent (pasfile://— Chromium peut altérer le canevas avec les origines d'images locales).
Contrat de fichiers
<target>/
├── <slug>/ # dossier d'images
│ ├── <slug>.mp4 # la source (conservée)
│ ├── frame-001.jpg
│ ├── frame-002.jpg
│ └── … frame-NNN.jpg
├── <slug>.html # la page d'accueil
├── style.css # partagé (copier si autonome)
├── parallax.js # partagé (copier si autonome)
└── index.html # le hub (uniquement si autonome ou intégration)
Le nom du dossier d'images et le nom du fichier HTML DOIVENT partager le même slug — l'option folder dans l'appel new ParallaxPage({folder: '<slug>', ...}) de la page est le chemin littéral du dossier.
L'API ParallaxPage (déjà dans parallax.js, ne pas redéfinir)
new ParallaxPage({
folder: '<slug>', // dossier contenant frame-001.jpg, etc.
frameCount: 145, // nombre entier
prefix: 'frame-', // toujours 'frame-' pour cette compétence
scrollBudget: 4200, // pixels d'entrée accumulés pour un passage complet
// optionnel : padWidth (par défaut 3), ext (par défaut 'jpg')
})
La classe attache automatiquement body.scrub-page (qui verrouille le défilement via CSS), précharge toutes les images, exécute un lerp piloté par RAF (facteur 0,22) vers l'image cible dérivée du défilement, et fait un fondu enchaîné des scènes dont les plages data-start/data-end incluent la progression actuelle.
Contraintes strictes (les non-négociables)
Elles sont intégrées dans la référence et brisent l'expérience si elles sont violées :
- 5 scènes, fenêtres de progression fixes :
0,00–0,20,0,22–0,40,0,42–0,60,0,62–0,80,0,82–1,00. L'écart de 0,02 entre les scènes est intentionnel — c'est un moment "juste l'image, pas de texte" entre les battements. Le héros (scène 1) et la finale (scène 5) utilisent respectivementdata-fade="0,30"etdata-fade="0,18"pour qu'ils tiennent plus longtemps aux bords ; les scènes du milieu utilisent le défaut 0,25. - Pas de section
.enden dessous du défilement. La scène finale contient les CTA. Toute la page est une fenêtre d'affichage verrouillée. - Anton + Caveat + Inter — Anton en majuscules pour tout ce qui est gras, Caveat pour les accents manuscrits (or/ambre/crème), Inter pour tout texte de corps principal. Ne jamais substituer, ne jamais ajouter une quatrième police.
- Blanc cassé
#f5f1ea, jamais#fff— déjà dans le CSS sousvar(--text). - Les noms d'images sont
frame-NNN.jpgcomplétés par des zéros sur la largeur du total (3 chiffres est la norme car les clips font moins de 1000 images ; le JS calcule automatiquement la largeur du compteur à partir du total). - Le slug est le nom du dossier ET le nom de base du fichier HTML —
hope/,hope.html. Aucune exception ; les étapes d'intégration supposent cela.
Où chercher en cas de problème
- La galerie de référence fournie dans ce dépôt :
examples/parasites/— github.html, lion.html, hope.html, style.css, parallax.js, index.html. Si votre résultat s'écarte visuellement de ceux-ci, vous avez dérivé ; relisez. references/copy-guide.md— comment écrire les 5 scènes pour qu'elles soient vraiment cinématographiques.references/showcase-integration.md— modifications exactes nécessaires lors de l'ajout à un hub existant.assets/landing-page-template.html— la structure canonique avec les espaces réservés.assets/hub-template.html— utilisé uniquement lors de la création d'une toute nouvelle galerie (3 cartes à partir de zéro).
Deux exemples d'invocations réelles
Autonome : l'utilisateur a un seul clip desk.mp4 et souhaite une page d'accueil.
- Demandez le slug + le thème. Exécutez l'extracteur sur
desk.mp4→./desk/frame-NNN.jpg. - Copiez
style.css+parallax.jsdans le dossier racine du projet. - Créez
desk.htmlà partir du modèle. La navigation a un seul lien : elle-même. - Terminé. Dites à l'utilisateur de servir avec
python -m http.server.
Ajout à une galerie : l'utilisateur ajoute hope.mp4 au dossier parasites existant.
- Slug =
hope. Extraction →hope/frame-NNN.jpg. (Réutilisez style.css + parallax.js existants.) - Créez
hope.htmlà partir du modèle. - Exécutez l'intégration à la galerie : ajoutez une troisième carte à
index.html, ajoutez un lienHopedans la barre de navigation degithub.htmletlion.html, enchaînez la scène finale de la page d'accueil précédente avec un CTASuivant : Hope →. - Si vous introduisez une nouvelle couleur d'accent, ajoutez-la dans
:rootet ajoutez les règles.script.X+.cta.Xdansstyle.css.