Construction de sites web
Construisez des sites web distinctifs et de qualité production, en évitant l'esthétique générique de l'IA. Chaque choix — typographie, couleur, mouvement, mise en page — doit être intentionnel. Déployez sous forme de bundles HTML/CSS/JS statiques sur S3.
Cette compétence couvre tout ce qui concerne les projets web. Lorsqu'elle est chargée via load_skill("website-building"), tous les fichiers sont copiés dans workspace/. Lisez les sous-fichiers selon les besoins de votre projet. Pour les applications web, chargez la compétence enfant : load_skill("website-building/webapp").
Les principes de conception universels (philosophie des couleurs, palette par défaut, sélection des polices) sont partagés avec d'autres compétences via design-foundations. Les fichiers partagés de cette compétence étendent ces fondations avec une implémentation spécifique au web (variables CSS, jetons réactifs, feuilles de style de base). Vous n'avez pas besoin de charger design-foundations séparément — les versions spécifiques au web dans shared/ sont complètes.
Utilisez read avec le chemin complet, par exemple shared/01-design-tokens.md
Routage par type de projet
Étape 1 : Identifiez le type de projet et chargez les directives spécifiques au domaine :
| Type de projet | Action | Exemples |
|---|---|---|
| Sites d'information | read informational/informational.md | Sites personnels, portfolios, éditoriaux/blogs, petites entreprises, pages d'accueil |
| Applications web | load_skill("website-building/webapp") | Produits SaaS, tableaux de bord, panneaux d'administration, e-commerce, expériences de marque |
| Jeux navigateur | read game/game.md + game/game-testing.md | Jeux Canvas 2D, Three.js/WebGL, jeux HTML5, expériences 3D interactives |
Étape 2 : Lisez les fichiers partagés — lisez shared/01-design-tokens.md et shared/02-typography.md en premier (obligatoire pour TOUS les types de projets, y compris les applications web). Ceux-ci établissent les valeurs par défaut du système de design Nexus et les règles typographiques qui s'appliquent universellement. Pour les applications web et les tableaux de bord, ignorez les fichiers marqués avec † ci-dessous — ceux-ci contiennent des détails d'implémentation préconfigurés dans le modèle fullstack.
Si l'utilisateur dit simplement « site web » ou « site » sans détails, demandez quel type ou par défaut pour les sites d'information.
Référence des sous-fichiers
Partagés (shared/) — Chaque projet
| Fichier | Couvre | Chargement |
|---|---|---|
shared/01-design-tokens.md | Échelle typographique, espacement, palette Nexus, base.css | Toujours |
shared/02-typography.md | Sélection de polices, appairage, chargement, liste noire | Toujours |
shared/04-layout.md | Composition spatiale, responsive, mobile-first | Toujours † |
shared/05-taste.md | Chargeurs squelettes, états vides/erreur, polissage | Toujours |
shared/08-standards.md | Accessibilité, performance, anti-modèles | Toujours |
shared/09-technical.md | Structure du projet, bac à sable, déploiement, liste de vérification | Toujours † |
shared/03-motion.md | Animations de défilement, bibliothèque Motion, plugins SVG GSAP, survol/curseur | Quand animé |
shared/06-css-and-tailwind.md | Tailwind CSS v3, shadcn/ui, CSS moderne | Quand vous utilisez Tailwind |
shared/07-toolkit.md | Bibliothèques CDN, React, Three.js, icônes, cartes, motifs/filtres SVG, esm.sh | Quand vous choisissez des bibliothèques |
shared/10-charts-and-dataviz.md | Chart.js, Recharts, D3, KPI, sparklines | Quand la visualisation de données est nécessaire |
shared/11-web-technologies.md | Versions des frameworks, compatibilité navigateur | Lors de la vérification de la compatibilité |
shared/12-playwright-interactive.md | Persistant QA navigateur Playwright, captures d'écran, tests visuels | Lors des tests |
shared/19-backend.md | Serveurs FastAPI/Express/Flask, WebSocket, SSE, transfert de port | Quand un backend est nécessaire |
shared/20-llm-api.md | Chat LLM, génération d'images/vidéos/audio, transcription — modèles, identifiants, SDK d'aide | Quand le site utilise des API IA/LLM |
Tous les chemins sont relatifs à ``.
† Ignorer pour les applications web et les tableaux de bord — détails d'implémentation préconfigurés dans le modèle fullstack. Les jetons de design et la typographie NE sont PAS ignorés — ils fournissent les valeurs par défaut du système de design et les directives de sélection de polices pour tous les types de projets.
Spécifiques au domaine — Chargez-en un
| Fichier | Quand charger |
|---|---|
load_skill("website-building/webapp") | SaaS, tableau de bord, administration, e-commerce, expérience de marque (compétence enfant avec modèle fullstack) |
skills/website-building/webapp/dashboards.md | Tableau de bord ou interface à forte densité de données (compagnon de l'application web) |
informational/informational.md | Site personnel, portfolio, éditorial, petite entreprise, page d'accueil |
game/game.md | Jeu navigateur, Three.js, WebGL, 3D interactif |
game/2d-canvas.md | Jeu Canvas 2D (compagnon de game.md) |
game/game-testing.md | Tout jeu navigateur — chargez-le avec game.md |
QA interactif : Lisez shared/12-playwright-interactive.md pour l'automatisation persistante du navigateur avec Playwright (captures d'écran, tests fonctionnels, QA visuel). Requis pour les tests de jeux, utile pour tout site complexe.
Flux de travail
- Direction artistique : Clarifiez l'objectif, choisissez une direction esthétique
- Contrôle de version : Exécutez
git initdans le répertoire du projet après l'échafaudage. Validez après chaque étape majeure avec un message court. - Construction : Construisez le site page par page, en prenant des captures d'écran via Playwright pour le QA visuel
- Publication : Validez toutes les modifications, puis
deploy_website()renvoie une URL publique
Utilisez tous les outils
- Recherchez d'abord. Cherchez sur le web des sites de référence, des tendances et des exemples de concurrents avant de concevoir. Parcourez des exemples primés du type de site spécifique. Récupérez toutes les URL fournies par l'utilisateur.
- Générez des actifs réels — généreusement. Générez des images pour les héros, les illustrations de section, les visuels éditoriaux, les arrière-plans atmosphériques — pas seulement une seule image de héros. Chaque page longue doit avoir un rythme visuel avec des images générées qui correspondent à la direction artistique du site. Pas d'espaces réservés. Générez un logo SVG personnalisé pour chaque projet (voir ci-dessous) — le SVG est pour les logos uniquement, sauf si l'utilisateur demande explicitement une sortie SVG. Enregistrez des images de référence web qui informent la direction.
- Prenez des captures d'écran via Playwright (sites complexes uniquement). Pour les sites multi-pages, les applications web, les tableaux de bord et les jeux, lisez
skills/website-building/shared/12-playwright-interactive.mdpour prendre des captures d'écran à la fois en bureau (1280px+) et en mobile (375px). Ignorez Playwright pour les sites statiques simples d'une seule page — voir QA visuel ci-dessous. - Écrivez directement du code de production. HTML, CSS, JS, SVG. Utilisez bash pour les outils de construction et le traitement des fichiers.
Génération de logo SVG
Chaque projet reçoit un logo SVG personnalisé intégré. Ne remplacez jamais par un en-tête de texte stylisé.
- Comprenez la marque — objectif, ton, un mot déterminant
- Écrivez SVG directement — formes géométriques, lettres ou marques abstraites. Une forme mémorable.
- Principes : Géométrique/minimal (Paul Rand, Vignelli). Fonctionne à 24px et 200px. Monochrome d'abord — ajoutez la couleur en amélioration. Utilisez
currentColorpour les modes clair/sombre. - Implémentez intégré avec
aria-label,viewBox,fill="none", traitscurrentColor - Générez un favicon — version simplifiée 32x32 si nécessaire
Pour l'animation SVG (DrawSVG, MorphSVG), voir shared/03-motion.md. Pour les motifs/filtres SVG, voir shared/07-toolkit.md.
Processus de test QA visuel
Quand utiliser Playwright QA
Ignorez Playwright pour les sites simples. Les sites statiques d'une seule page n'ont PAS besoin de captures d'écran Playwright. Examinez le code directement, puis déployez. Playwright QA ajoute un temps considérable et n'en vaut pas la peine pour un contenu statique simple.
Utilisez Playwright pour les sites complexes. Les sites multi-pages, les applications web, les tableaux de bord, les jeux et tout site avec des fonctionnalités interactives (formulaires, paniers, filtres, graphiques, glisser-déposer) DOIVENT utiliser Playwright QA. Lisez skills/website-building/shared/12-playwright-interactive.md pour l'automatisation persistante du navigateur.
Processus Playwright QA (sites complexes uniquement)
Cycle : Construire → Playwright QA → Évaluer → Corriger → Répéter → Déployer quand prêt
Étape 1 : QA page par page
Après avoir construit chaque page :
- Prenez une capture d'écran en bureau (1280px+) et mobile (375px) via Playwright
- Évaluez de manière critique : A-t-il l'air professionnellement conçu (pas généré par IA) ? La typographie est-elle distinctive ? Les espaces blancs sont-ils généreux ? Y a-t-il une hiérarchie visuelle claire ?
- Corrigez chaque problème avant de passer à la suite. Pas de dette visuelle.
Étape 2 : QA final (avant publication)
- Prenez une capture d'écran de chaque page en bureau et mobile
- Vérifiez la cohérence entre les pages (espacement, couleur, traitement typographique)
- Vérifiez le mode sombre (prenez une capture d'écran des deux thèmes pour la page d'accueil au minimum)
- Vérifiez les états interactifs : survol, focus, actif, chargement, vide, erreur
- Test d'impression à froid : a-t-il l'air soigné et intentionnel ?
Échecs QA : débordement de texte, espacement incohérent, couleurs hors norme, mode sombre manquant, mobile écrasé, aspect générique IA, contenu d'espace réservé, logo manquant.
Étape 1 : Direction artistique — Inférez avant de demander, demandez avant de prendre par défaut
Chaque site doit avoir une identité visuelle dérivée de son contenu. Ne passez pas directement à la palette de secours Nexus. La palette Nexus est un dernier recours lorsque l'inférence et la demande ont toutes deux échoué — pas un défaut pratique.
- Inférez à partir du sujet. Un site de torréfacteur → bruns terreux, crème chaude, aspect dessiné à la main. Un tableau de bord fintech → ardoise froide, sans-serif net, dense en données. Une application d'apprentissage pour enfants → primaires vives, typographie arrondie, mouvement ludique. Le contenu lui-même vous indique la palette, la typographie et l'espacement avant que l'utilisateur ne dise un mot.
- Consultez les tableaux de direction artistique. Chaque fichier de domaine (
informational.md,webapp/SKILL.md,game/game.md) a un tableau de direction artistique mappant les types de sites/produits à des directions conceptuelles et des points de départ de jetons. Utilisez-les comme tremplin. - Dérivez les cinq piliers : Couleur (chaude/froide, accent du sujet), Typographie (serif/sans, personnalité d'affichage), Espacement (dense/généreux), Mouvement (minimal/expressif), Imagerie (photo/illustration/type uniquement).
- Si le sujet est vraiment ambigu, demandez — « Quelle ambiance visez-vous ? » et « Des sites de référence ? » Une question suffit.
- Repli Nexus — uniquement lorsque l'inférence ET la demande ne donnent rien. Si l'utilisateur a été interrogé et n'a donné aucune direction, ET que le sujet ne donne aucun signal clair, alors revenez aux valeurs par défaut Nexus/Suisse.
Le repli : Propre et suisse (dernier recours)
Lorsque l'inférence n'a donné aucune direction claire ET que l'utilisateur a été interrogé mais n'a donné aucune directive de style, utilisez les valeurs par défaut de shared/01-design-tokens.md avec :
- Typographie : Satoshi ou General Sans pour le corps (Fontshare — préféré), ou Inter/DM Sans. Contraste de poids plutôt que contraste de polices. 3-4 tailles maximum. Gardez le texte compact —
--text-3xl/--text-herosont pour les héros de sites d'information uniquement. - Couleur : Palette Nexus. Surfaces neutres + un accent sarcelle pour les CTA uniquement.
- Mise en page : Aligné sur la grille. Marges généreuses. Asymétrique là où c'est intéressant.
- Mouvement : Minimal, fonctionnel. Transitions d'état fluides uniquement.
- Imagerie : Générez des visuels propres et pertinents. Pas de photos stock.
Direction artistique — Évitez l'esthétique IA
Voir shared/08-standards.md pour la liste complète des anti-modèles.
Étape 2 : Publier
Appelez deploy_website() avec le chemin du projet et le nom du site. Renvoie une URL publique S3. Pour mettre à jour, modifiez les fichiers locaux et redéployez avec le même chemin. Voir shared/09-technical.md pour l'appel exact et des exemples.