Que fait webbuild ?
Créez des sites web pour lesquels un chef d'entreprise paierait : spécifiques à lui, rapides sur mobile, un moment mémorable, et rien qui crie « une IA a fait ça ». Le savoir-faire réside surtout dans les choix avant le code et dans le regard honnête porté sur le résultat après.
Les chemins ci-dessous sont relatifs au dossier de cette compétence (scripts/, references/, assets/).
0. Configurer le projet (2 min)
- Nouveau site → copier
assets/starter/dans le dossier du projet (HTML + CSS + modules ES, imports CDN épinglés, pas de build : déploiement partout, facile à éditer). N'utiliser Next.js / Astro / R3F que si l'utilisateur le demande ou si le projet les utilise déjà (references/3d-playbook.md§5). - Projet existant → conserver son framework, ses tokens et ses composants ; cette compétence ajoute la direction, le motion design et le QA, pas une réécriture.
- Créer
BUILD_NOTES.mddans le projet. C'est la mémoire entre les remises à zéro du contexte : brief, décisions, questions ouvertes, corrections qui ont fonctionné.
1. Brief — obtenir le vrai business
Rassembler (auprès de l'utilisateur, du site actuel du commerce, du Google Business Profile, Instagram) : nom, ce qu'ils vendent, où, depuis quand, la seule action primaire (appeler / réserver / commander / devis / visiter), une preuve réelle (note + nombre d'avis, années d'activité, licences, presse), des photos réelles, logo/couleurs, horaires, adresse, téléphone. Rédiger le brief en 5 lignes depuis references/design-system.md §2 dans BUILD_NOTES.md.
N'inventez jamais de faits — des avis, statistiques, prix ou adresses fabriqués dans un pitch détruisent la confiance dès que le propriétaire les lit. À la place :
- Écrire autour des inconnues pour que la démo reste aboutie : « Koregaon Park, Pune » au lieu d'un numéro de rue inventé ; « Noté 4,7 sur Google » au lieu de citations inventées ; des noms de services sans prix, ou « à partir de …€ » seulement si connu.
- Quand un fait est vraiment requis (téléphone, adresse exacte, horaires), utiliser un
{{placeholder}}visible —slop_check.pybloque le livrable jusqu'à ce qu'il soit rempli. - Mettre chaque inconnue et chaque hypothèse dans une liste « À demander au client » pour le rapport final.
Pour un site de créateur ou de chaîne, demander (ou récupérer) les chiffres du tableau de bord et la photo de profil en amont : captures YouTube Studio / Instagram Insights, plus vidIQ ou similaire si connecté. Une section Résultats bâtie sur des chiffres réels est ce qui vend le projet.
Si le brief est mince et que l'utilisateur est présent, poser au maximum 3 questions (commerce + ville, action primaire, un site qu'ils aiment). S'ils veulent que vous y alliez, faire des hypothèses raisonnables, les écrire, et continuer.
2. Référence (quand l'utilisateur nomme un site, envoie un enregistrement ou veut une « reconstruction »)
Suivre references/reverse-engineer.md : node scripts/teardown.mjs <url> mesure la stack, les polices, la palette, les médias et les indices de shaders et capture le défilement ; les enregistrements d'écran deviennent des images que vous lisez et transformez en spécification de mouvement battement par battement. Quand cette passe rapide ne peut pas expliquer un effet, aller plus loin avec le moteur REA : scripts/rea-teardown.sh <url> capture la page, identifie le bundle et exporte chaque script pour que vous puissiez lire comment il est réellement construit (guides dans references/rea/). Enregistrer OBSERVÉ → INFÉRENCE → DÉCISION. Apprendre la technique ; ne jamais copier la marque, le copy, les assets ou le code.
3. Direction — planifier, puis attaquer le plan
Lire references/design-system.md (les règles anti-slop — classiques et les signes plus récents de l'IA « de bon goût » comme crème + terre cuite, les titres en CAPITALES, les filets éditoriaux). Dans BUILD_NOTES.md, écrire :
- 4 à 6 tokens de couleur nommés tirés du commerce, appairage de polices + rôles, langage des coins
- wireframe ASCII de chaque section (varier le rythme — pas de hero → 3 cartes → logos → témoignages)
- le moment signature (un seul) et pourquoi il correspond à ce commerce
- 3 principes qui le rendent distinctif
Ensuite, passer le plan en revue par rapport à la liste des signes et, pour chaque choix qui ressemble à une valeur par défaut, le justifier pour ce commerce ou le changer. Se demander « est-ce que cela pourrait appartenir à un autre commerce si je changeais le logo ? » attrape la plupart des problèmes ici, quand ils sont peu coûteux.
Pour une direction indécise que l'utilisateur veut choisir, montrer 2 à 3 directions vraiment différentes (une image fixe ou une esquisse HTML rapide chacune) avant de construire — 21st-ui-explore peut aider s'il est installé.
4. Hero — choisir le mode qui sert le commerce
references/3d-playbook.md §1 contient le tableau de décision. Version courte :
- fixe (belle photo/typo) — restaurants, salons, cliniques, services. Souvent le bon choix.
- vidéo — boucle d'ambiance, idéalement traitée avec
assets/starter/grade.jspour que les images IA/stock reçoivent un grade sur mesure (grain, halation, lift/gamma/gain, vignette). Choisir un LOOK et le garder subtil. - images clés — le « site 3D à 10 000€ » : images clés IA de début/fin → vidéo première/dernière image →
scripts/frames.sh→ canvas défilé par le scroll. Lirereferences/scroll-video-playbook.mdpour les règles d'images clés, les prompts et le mélange. - scène — Three.js / R3F en direct quand la 3D est l'histoire du produit (produit configurable, architecture, tech). Le sujet doit être la chose du commerce, jamais le nœud générique.
- page entière — quand le propriétaire demande un « site 3D », il veut généralement de la 3D partout, pas seulement un hero 3D. Utiliser une scène fixe avec une caméra par section (
references/3d-playbook.md§6).
Générer les assets avec ce qui est connecté (Higgsfield / Kling / kie.ai / Nano Banana MCPs ou compétences), ou demander à l'utilisateur de déposer les fichiers. Si rien n'est disponible, construire avec un placeholder clairement étiqueté et lister exactement quel asset générer, avec le prompt.
5. Build
Ordre : tokens (styles.css :root) → sections HTML sémantiques avec le vrai copy → mise en page à 390px et 1440px → mode hero → motion en dernier.
- Règles de copy :
references/design-system.md§8 (résultat + lieu + spécificités, verbes CTA réels, mots interdits). - Requis pour un site d'entreprise : un CTA évident au-dessus de la ligne de flottaison et à nouveau à la fin,
tel:/ réservation / formulaire, horaires + adresse + lien map, preuve réelle, titre + description + image OG, JSON-LD LocalBusiness, favicon, barre d'appel/réservation collante sur mobile quand l'action est un appel. - Motion : un moment signature + micro- retour silencieux de 150 à 300 ms ; ease-out, jamais de rebond ; uniquement
transform/opacity; motion réduite affiche les états finaux. - Composants : chercher dans les registres
references/resources.md(21st.dev, React Bits, Aceternity, Motion Primitives…) avant de coder à la main des effets complexes, puis restyler avec les tokens. Dans un site statique, reconstruire les composants React en vanilla plutôt que d'ajouter React pour un seul effet. - Footer : le construire selon
references/design-system.md§11 (bloc de marque, colonnes de liens avec logos de plateformes, boutons de contact, mot-symbole surdimensionné, ligne du bas). Les propriétaires jugent tout le site sur le footer. Le petit crédit du constructeur est déjà dans le starter ; le client peut demander à le retirer. - Boutons et scroll : suivre
references/design-system.md§12 (boutons tactiles de 0,16 s, anneau de curseur viacursor.jsdu starter, pas de barre de défilement native :blockbar.jsdu starter la remplace). - Avant de considérer le site comme terminé, relire
references/design-system.md§10 : ce que les propriétaires appellent encore « slop » alors que toutes les règles sont respectées.
6. Le regarder — c'est là que les bons sites se font
Servir localement (npx serve . ou le serveur de dev du projet), puis :
node scripts/shoot.mjs http://localhost:3000 ./shots— captures d'écran téléphone / portable / bureau le long du défilement + erreurs console, débordement, LCP, poids. Lire les PNG. (Ou utiliser le volet navigateur / Playwright MCP si disponible.) Exécuter aussi une fois avec--reduced-motion.python3 scripts/slop_check.py .— doit se terminer avec 0 FAIL. Traiter les WARN comme des questions. (npx impeccable detectest un bon second avis s'il est installé.)- Critiquer honnêtement par rapport au brief : hiérarchie, typo, couleur, moment signature, mobile, spécificité du copy. Corriger par lots avec une intention claire ("les sections basses ont l'air génériques — rendez-les plus chères, pas plus chargées").
- Soustraire un élément décoratif avant de le déclarer terminé.
Prévoir 3 à 6 cycles ; personne ne réussit du premier coup. Enregistrer ce qui a corrigé quoi dans BUILD_NOTES.md.
7. Livrer + pitcher
- Déployer : Vercel / Netlify / Cloudflare Pages / GitHub Pages. Commiter le dossier frames (le bug le plus courant : « le hero a disparu en production »). Ajouter
<meta name="robots" content="noindex">aux démos de spécification jusqu'à ce que le client achète. - S'il s'agit d'un pitch, lire
references/pitch-and-sell.md: vidéo avant/après, scripts de prospection, ancres de prix, checklist prêt-à-pitcher, remise.
Rapport final à l'utilisateur
Rester court et concret :
- Ce qui a été construit (direction en une ligne, moment signature, mode hero) et où (chemins, URL)
- Comment l'exécuter (
npx serve .ou la commande dev) - Résultats du QA : nombres FAIL/WARN de slop_check, LCP / erreurs par viewport de shoot.mjs, ce que vous avez examiné et corrigé
- Liste À demander au client : chaque
{{placeholder}}et hypothèse - Assets encore à générer (avec des prompts prêts à l'emploi), le cas échéant
Carte de référence
| À lire | Quand |
|---|---|
references/design-system.md | Toujours, avant de choisir couleur/typo/layout/copy |
references/3d-playbook.md | Choisir le hero ; tout Three.js/R3F ; budget performance + a11y |
references/scroll-video-playbook.md | Hero « 3D » défilé au scroll à partir d'une vidéo IA |
references/reverse-engineer.md | Un site de référence, un enregistrement, ou la reconstruction du site d'un prospect |
references/rea/README.md | Aller plus loin que teardown.mjs avec les outils REA |
references/resources.md | Registres de composants, outils d'effets, inspiration, compétences compagnons |
references/pitch-and-sell.md | Site de spécification pour un prospect, tarification, prospection, remise |
| Script | Fait |
|---|---|
scripts/teardown.mjs <url> | Mesurer un site de référence (stack, polices, palette, médias, shaders, captures d'écran) |
scripts/rea-teardown.sh <url> | Déconstruction approfondie avec le moteur REA : capture de page, empreintes du bundle, scripts exportés |
scripts/frames.sh <video> <out> | Vidéo → séquences d'images WebP (desktop + mobile) + manifeste |
scripts/shoot.mjs <url> [out] | Captures d'écran à 3 largeurs le long du défilement + erreurs/LCP/débordement |
scripts/slop_check.py <dir> | Linter anti-slop + préparation à la livraison (0 FAIL pour livrer) |
Playwright pour les scripts .mjs : npm i -D playwright && npx playwright install chromium.