Site vitrine produit
Une recette, distillée du site marketing Kesami, pour une page statique unique qui a l'air conçue plutôt que templatisée et qui résiste à l'examen : contraste vérifié, accessible au clavier, honnête sur le produit, rapide.
Le résultat est une page Next.js composée de sections rendues côté serveur. L'interactivité est limitée à quelques petites « îles » clientes qui modifient des attributs DOM ou des variables CSS au lieu de re-rendre. Pas de bibliothèque UI, pas de Tailwind, pas de bibliothèque d'animation.
Ce qui est fourni
| Chemin | Utilisation |
|---|---|
assets/scaffold/ | Un site complet et fonctionnel (vérifié par tsc et next build). Copiez-le, ne le retapez pas. Contenu de démonstration, système de design fonctionnel. |
assets/optional-sections/ | Trois sections supplémentaires du site original (comparaison avant/après, arborescence de fichiers avec données, mur de scripts) comme exemples travaillés. Non câblées. |
scripts/accent.mjs | Calcule les nuances d'accent respectant le contraste pour n'importe quelle couleur de marque. |
scripts/capture.cjs | Prend des captures d'écran du site en cours d'exécution aux largeurs desktop et mobile, en parcourant le défilement, via une fenêtre Electron hors écran. |
references/design-system.md | Tokens, thèmes, typographie, espacement, logique de contraste des accents, et pourquoi chacun existe. À lire avant de modifier les couleurs ou la typographie. |
references/section-patterns.md | Chaque section : à quoi elle sert, comment elle est construite, l'astuce qui la rend économique. À lire avant d'ajouter ou de remodeler une section. |
references/motion-and-a11y.md | Budget d'animation, mouvement réduit, sans JS, cibles tactiles, pièges d'hydratation. À lire avant d'ajouter une animation ou du code client. |
references/copy-and-facts.md | Ton, règle du scénario unique, et comment garder les affirmations vraies. À lire avant d'écrire le contenu. |
references/verify.md | La liste de vérification et les commandes à exécuter avant de considérer le site comme terminé. |
Flux de travail
1. Rassembler les informations (regarder avant de demander)
Lisez d'abord le README du produit, son manifeste, le code des tarifs/abonnements et le workflow de publication ; la plupart des réponses s'y trouvent. Ne demandez à l'utilisateur que ce qui ne peut pas être trouvé. Vous avez besoin de :
- Nom du produit, promesse en une phrase, à qui il s'adresse, et la chose qui le distingue.
- Plateformes, prix et limites des forfaits, chacun avec le fichier qui est la source de vérité.
- Une couleur de marque (n'importe quel hexadécimal), ou l'autorisation d'en choisir une. Choisissez une seule couleur et utilisez-la comme unique couleur de signal.
- Savoir s'il existe une police d'affichage sous licence. Sinon, le substitut open-source du scaffold (Instrument Serif) convient.
- Quelles sections s'appliquent. Ensemble par défaut : Hero, ticker, Comment ça marche, Demande/démo, Tarifs, FAQ, Conclusion, Pied de page. Ajoutez Confidentialité, Langues ou une comparaison avant/après quand le produit a une histoire qui le nécessite.
- Où se trouve le site. Par défaut : un dossier
website/dans le dépôt du produit, un package autonome en dehors de tout npm workspace pour que les installations et le fichier de verrouillage de l'application restent intacts.
2. Scaffolding
cp -R ~/.claude/skills/product-landing-site/assets/scaffold <target>/website
cd <target>/website && npm install && npx tsc --noEmit && npx next build
Exécutez la construction une fois avant de modifier quoi que ce soit pour vous assurer que la base est verte. Mona Sans est récupérée depuis Google Fonts au moment de la construction puis servie depuis le site lui-même, donc la première construction nécessite un réseau.
3. Marque
node ~/.claude/skills/product-landing-site/scripts/accent.mjs <brand-hex>affiche--accent,--accent-display, la teinte aplatie, et si l'étiquette du bouton doit être en encre ou en blanc. Mettez ces valeurs dansapp/globals.css(--brand,--brand-hover,--brand-tint,--accent,--accent-display) et remplacez les valeurs codées en dur#ff5e00/#e25300dansapp/icon.svgetapp/opengraph-image.tsx.- Redessinez la marque dans
components/Logo.tsxetLogo.module.css(l'espace réservé est constitué de quatre barres vocales). Gardez-la sous forme de divs ou de SVG en ligne, jamais de bitmap. - Définissez
SITEdanslib/site.ts(nom, slug, mot-clé, titre, accroche, CTA, note). Leslugsert également à espacer la préférence de devise dans localStorage.
Pourquoi le script plutôt que de procéder à l'œil : une couleur de marque saturée atteint presque jamais 4.5:1 en tant que texte sur une page claire, donc la page a besoin de la couleur de marque pour les remplissages et d'une nuance plus foncée pour le texte. Deviner la nuance est ainsi que les sites expédient des contrastes défaillants.
4. Faits avant le texte
Remplissez lib/site.ts (forfaits, plateforme, liens, FAQ) à partir des fichiers source du produit lui-même, et enregistrez la source de chaque fait dans le README.md du site sous "D'où viennent les faits". Gardez la provenance dans le README plutôt que dans les commentaires du code, afin que le scaffold reste sans commentaires. Si le dépôt cible ou l'utilisateur demande des commentaires explicatifs, suivez plutôt cela.
Ensuite, lisez references/copy-and-facts.md et rédigez le texte.
5. Un scénario, partagé partout
lib/demo.ts contient un seul scénario fictif que la maquette du hero, l'histoire du produit et la démo interactive utilisent tous. Remplacez-le par un scénario du propre domaine du produit (tickets de support, une pull request, un calendrier, une feuille de calcul, une réunion). Parce que chaque section lit les mêmes données, la page ne se contredit jamais, et la démo peut honnêtement montrer le véritable contrat du produit (par exemple, chaque affirmation cite sa source).
6. Sections
Commencez par les neuf sections du scaffold. Pour chaque section, décidez : quelle idée unique porte-t-elle, et quelle est la preuve visuelle unique qui la démontre plutôt que la décrit ? Lisez references/section-patterns.md. Respectez la grammaire des sections :
- une étiquette de catégorie (
.label, avecdata-scramble), puis unh2.display.h2dont les derniers mots sont dans.em, puis un.leadoptionnel - les sections alternent
data-theme="light"/"paper"afin que chacune commence sur une bordure de couleur, pas sur une ligne de règle - un bouton rempli par vue ; tout le reste est un lien texte avec le soulignement de la marque
- les maquettes de produit utilisent
data-theme="dark"et des tailles en px, car elles remplacent des captures d'écran de l'application (sombre). Si l'application est claire, rendez les maquettes claires.
7. Vérification
Suivez references/verify.md. En résumé : vérification de type, construction, captures d'écran à 1440 et 390 avec scripts/capture.cjs, lisez-les, parcourez le défilement pour confirmer que les révélations se déclenchent, vérifiez le mouvement réduit et sans JS, réexécutez accent.mjs --check pour toute nouvelle couleur de texte. Signalez tout ce qui n'est pas vérifié plutôt que de l'ignorer.
Non-négociables, et pourquoi
- Composants serveur par défaut ; îles clientes uniquement pour le comportement. La page est du HTML statique qui fonctionne sans JS et coûte presque rien à hydrater. Les îles écrivent des attributs
data-*ou des variables CSS et laissent le CSS faire le travail visuel. - Tokens sémantiques uniquement dans les composants. Les composants lisent
--bg,--fg,--accent; ledata-themed'une section les échange. C'est ainsi qu'un même composant peut se trouver sur le canevas, le blanc, la teinte ou une maquette sombre sans modifications. - Tailles de texte en rem, maquettes en px. La taille de texte du navigateur du lecteur doit s'appliquer à la page ; les maquettes remplacent des captures d'écran.
- Le texte atténué recule par la couleur, jamais par l'opacité. L'opacité abaisse silencieusement le contraste en dessous de 4.5:1.
- Le contenu ne dépasse jamais le produit. Pas de plateformes non publiées, pas d'adresse de support qui n'existe pas, pas de "rien ne quitte votre appareil" si l'audio est diffusé vers un serveur. Une page marketing qui promet trop est un bug.
- Aucun contrôle de pause d'animation n'est intégré. Les animations en boucle s'arrêtent pour
prefers-reduced-motion. La revue de design Kesami a délibérément refusé un contrôle de pause, donc le scaffold n'en a pas ; proposez-en un si l'utilisateur le souhaite.
Aller au-delà du scaffold
Inventez de nouvelles sections avec les mêmes primitives plutôt que d'importer une bibliothèque : propriétés personnalisées CSS pour l'état, un IntersectionObserver par comportement, details/summary pour la divulgation, position: sticky pour le scrollytelling, @property pour animer des variables. Si vous vous surprenez à chercher framer-motion ou un package de carrousel, relisez d'abord references/motion-and-a11y.md ; la réponse est presque toujours une variable CSS et un attribut.