Que fait Parallax Landing Page ?
Transformez une courte vidéo en une page d'atterrissage cinématographique en un seul écran, où le geste de défilement de l'utilisateur parcourt la vidéo image par image tandis que cinq scènes de texte dramatiques s'estompent progressivement. Le document ne défile jamais réellement — l'entrée de la molette/du toucher/du clavier est interceptée en JavaScript et convertie en progression d'image virtuelle.
Cette compétence encode les modèles éprouvés dans la référence fournie à ../../examples/parasites/ (les pages d'atterrissage github / lion / hope — trois pages fonctionnelles construites avec exactement cette compétence). Traitez ce dossier comme la vérité absolue si quelque chose est ambigu.
Où se situe cette compétence dans la pyramide YUV.AI
parallax-landing-page se trouve 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 ici chaque fois qu'un clip vidéo de 5 à 15 secondes doit devenir une page d'atterrissage unique à défilement scrubbé.
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/deck, parallax-landing-page possède l'esthétique cinématographique de défilement scrubbé spécifiquement. Pour les pages d'atterrissage parallax YUV.AI, vous pouvez OPTIONNELLEMENT ajouter un filigrane du phénix + l'URL Linktree canonique dans la zone de 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 l'apparence signature.
Ce que vous construisez
Chaque page d'atterrissage est une seule fenêtre verrouillée 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 en majuscules + ligne manuscrite Caveat), chacune avec sa propre fenêtre de progression de défilement
- Une navigation fixe avec le logo
PARALLAX // showcaseet des liens vers les pages d'atterrissage sœurs - Un chargeur qui précharge chaque image avant de permettre à l'utilisateur d'interagir
- Une superposition de vignette + grain de film
- Un indice de défilement en bas qui disparaît dès 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 ips = 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'atterrissage autonomes ici pour pouvoir les retrouver. Ne remplacez que si l'utilisateur choisit explicitement un emplacement différent OU si le mode B (intégration dans la vitrine existante examples/parasites/) est sélectionné.
mkdir -p ~/Documents/yuv-projects/landings
cd ~/Documents/yuv-projects/landings
# La compétence crée <slug>/ ici pendant qu'elle extrait les images et construit le HTML.
Chemin final (Mode A — autonome) : ~/Documents/yuv-projects/landings/<slug>/.
Chemin final (Mode B — intégration) : le répertoire de vitrine existant choisi par l'utilisateur.
Indiquez le chemin final à l'utilisateur à la fin de chaque construction.
Flux 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 de dossier/fichier (ex.
hope,marcus,desk). Un mot, minuscules, sans espaces. Cela 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'atterrissage ? Un lancement de produit ? Un moment personnel ? Une rencontre avec la faune ? Vous en avez besoin pour écrire le texte.
- Mode du projet — autonome (nouveau dossier) ou intégration dans la vitrine existante
examples/parasites/(en haut de ce dépôt). Si l'utilisateur dit « ajoute-le à la vitrine », il veut dire Mode B ci-dessous. - Couleur d'accent — pour le script/la surbrillance du CTA :
gold(#f5b042),amber(#ff8a3d),accent(rose #ff4d6d),cream(#f5e9d4), ou quelque chose de nouveau (ajoutez-le dans:rootdans style.css et écrivez 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 continuez — ne vous attardez pas sur des questions auxquelles ils peuvent répondre une fois qu'ils voient 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 (remplissage à 3 chiffres avec des zéros).
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 les outils similaires recompressent agressivement (~55 Ko/image). FFmpeg natif à q:v 2 donne ~120–220 Ko/image aux mêmes dimensions — nettement 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) : maintient le tactile « pixels de défilement par image avancée » constant sur toutes les longueurs de clip. 145 images → ~4200, 241 images → ~6300, 90 images → ~2500 (plancher). Le script le calcule pour vous et le limite à [2500, 8000].
Phase 3 — Rédaction 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 éléments créatifs. Écrivez un nouveau fichier à <target>/<slug>.html avec tout substitué.
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 — The Fastest Heart in the Negev |
{{PAGE_DESCRIPTION}} | Méta description, une phrase | A moment with Hope, the cheetah of Midbarium. |
{{SLUG}} | Nom du dossier (pas de chemin, pas de barre oblique) | hope |
{{FRAME_COUNT}} | Nombre entier d'images | 241 |
{{FRAME_COUNTER_TEXT}} | 001 / NNN avec largeur correspondante | 001 / 241 |
{{SCROLL_BUDGET}} | Nombre entier du JSON de l'extracteur | 6300 |
{{PREVIEW_FRAME_MID}} | Image du milieu avec remplissage de zéros | 121 |
{{PREVIEW_FRAME_END}} | Dernière image avec remplissage de zéros | 241 |
{{LOADER_TITLE}} | Un mot, en majuscules | HOPE |
{{LOADER_SCRIPT}} | Ligne manuscrite se terminant par … | summoning the runner… |
{{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 en majuscules de 2 à 4 mots | SCROLL TO RUN |
{{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 |
Lisez references/copy-guide.md pour les motifs de rédaction cinématographique (phrasé de l'accroche, longueur du titre, ton de la ligne manuscrite). Le texte est ce qui fait la valeur de 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 la vitrine), ne faites rien — ils sont partagés. Sinon, copiez les deux depuis <skill>/assets/ dans 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 vitrine existante, effectuez également les étapes dans references/showcase-integration.md — ajoutez une carte à index.html, ajoutez un lien dans la barre de navigation de chaque page d'atterrissage existante, et ajoutez le CTA de chaîne sur la scène finale de la page d'atterrissage précédente.
Dites à l'utilisateur comment visualiser :
Ouvrez
<target>/<slug>.htmlviapython -m http.server 8000depuis le dossier parent (pasfile://— Chromium peut altérer le canevas avec des 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'atterrissage
├── style.css # partagé (copier si autonome)
├── parallax.js # partagé (copier si autonome)
└── index.html # le hub (seulement 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 cumulée 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 estompe les 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 de « 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 tenir plus longtemps aux bords ; les scènes du milieu utilisent la valeur par défaut de 0.25. - Pas de section
.enden dessous du scrub. La scène finale contient les CTA. Toute la page est une seule fenêtre verrouillée. - Anton + Caveat + Inter — Anton en majuscules pour tout ce qui est en gras, Caveat pour les accents manuscrits (or/ambre/crème), Inter pour tout texte de corps principal. Ne remplacez jamais, n'ajoutez jamais une quatrième police.
- Blanc cassé
#f5f1ea, jamais#fff— déjà dans CSS commevar(--text). - Les noms d'images sont
frame-NNN.jpgremplis de zéros sur la largeur du total (3 chiffres est la norme car les clips < 1000 images ; le JS calcule automatiquement la largeur du compteur à partir du total). - Le slug est le nom du dossier ET la base du nom du fichier HTML —
hope/,hope.html. Aucune exception ; les étapes d'intégration supposent cela.
Où chercher quand vous êtes bloqué
- La vitrine 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 visiblement de ceux-ci, vous avez dévié ; relisez. references/copy-guide.md— comment écrire les 5 scènes pour qu'elles semblent 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 des espaces réservés.assets/hub-template.html— utilisé uniquement lors de la création d'une toute nouvelle vitrine (3 cartes à partir de zéro).
Deux exemples réels d'invocation
Autonome : l'utilisateur a un seul clip desk.mp4 et veut une page d'atterrissage.
- Demandez le slug + le thème. Exécutez l'extracteur sur
desk.mp4→./desk/frame-NNN.jpg. - Copiez
style.css+parallax.jsà la racine du projet. - Rédigez
desk.htmlà partir du modèle. La navigation a un seul lien : lui-même. - Terminé. Dites à l'utilisateur de servir avec
python -m http.server.
Ajout à une vitrine : l'utilisateur ajoute hope.mp4 au dossier parasites existant.
- Slug =
hope. Extraction →hope/frame-NNN.jpg. (Réutilisez style.css + parallax.js existants.) - Rédigez
hope.htmlà partir du modèle. - Exécutez l'intégration de la vitrine : ajoutez une troisième carte à
index.html, ajoutez un lienHopedans la barre de navigation degithub.htmletlion.html, chaînez la scène finale de la page d'atterrissage précédente avec un CTANext: Hope →. - Si vous introduisez une nouvelle couleur d'accent, ajoutez-la à
:rootet ajoutez les règles.script.X+.cta.Xdansstyle.css.