Communitygithub.com

xenxorowdy/product-landing-site

Construisez un site marketing d'une seule page, distinctif et accessible, pour un produit logiciel — Next.js App Router, composants serveur, modules CSS, un système typographique serif + large sans-serif, une couleur de signal, une maquette produit live dans le hero, une histoire produit animée par le défilement, une démo interactive, des tarifs, une FAQ et un pied de page avec un grand mot-clé.

Qu'est-ce que product-landing-site ?

Ce skill permet de générer un site vitrine ou une landing page pour un produit SaaS, une application ou un outil, en se basant sur l'architecture Next.js App Router avec des composants serveur, des modules CSS et un design system minimaliste. Inspiré du site Kesami, il produit une page statique, rapide, accessible (contraste validé, navigation clavier) et sans dépendances lourdes (pas de Tailwind, pas de librairie d'animation). Le flux de travail inclut la collecte des informations produit, le scaffolding d'un projet complet, l'application de la marque (couleur, logo, typographie), la rédaction de contenu véridique, la création de sections (Hero, tarifs, FAQ, démo interactive, etc.) et une vérification automatisée avec capture d'écran et tests d'accessibilité. Il est conçu pour être utilisé sur demande d'une landing page, d'un site marketing, d'une page de lancement ou de téléchargement, ou encore pour restyler un site existant suivant ce modèle.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add xenxorowdy/product-landing-site

Demander à votre IA préférée

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

Documentation

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

CheminUtilisation
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.mjsCalcule les nuances d'accent respectant le contraste pour n'importe quelle couleur de marque.
scripts/capture.cjsPrend 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.mdTokens, 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.mdChaque 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.mdBudget 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.mdTon, règle du scénario unique, et comment garder les affirmations vraies. À lire avant d'écrire le contenu.
references/verify.mdLa 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

  1. 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 dans app/globals.css (--brand, --brand-hover, --brand-tint, --accent, --accent-display) et remplacez les valeurs codées en dur #ff5e00 / #e25300 dans app/icon.svg et app/opengraph-image.tsx.
  2. Redessinez la marque dans components/Logo.tsx et Logo.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.
  3. Définissez SITE dans lib/site.ts (nom, slug, mot-clé, titre, accroche, CTA, note). Le slug sert é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, avec data-scramble), puis un h2.display.h2 dont les derniers mots sont dans .em, puis un .lead optionnel
  • 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 ; le data-theme d'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.

Skills associés