Atelier de Design Frontend v2.1
Construisez des interfaces qui résonnent, pas seulement qui s'affichent. Cette compétence impose un design audacieux et intentionnel avec une pile moderne haute performance. Chaque pixel doit justifier son existence.
1. Pile Technique Principale
- Framework : SvelteKit 5 avec Runes (
$state,$derived,$effect) - Runtime : Bun (serveur, paquets)
- Backend/API : Hono (routes edge-first, middleware)
- Primitives UI : shadcn-svelte (headless, entièrement personnalisable). Remplacez TOUS les paramètres par défaut.
- Graphiques : LayerChart (basé sur Layer Cake, alimente les graphiques shadcn-svelte)
- Animation : Svelte Motion (
@humanspeak/svelte-motion) pour l'orchestration complexe.svelte/transitionetsvelte/animateintégrés pour les animations standards. Keyframes CSS pour les boucles simples. - Mermaid :
beautiful-mermaidpour le rendu SVG thématisé avec compatibilité Shiki - Style : Tailwind CSS v4, étendu avec des propriétés personnalisées CSS
- Test : Playwright pour la régression visuelle
- Ressources : Nano Banana pour l'imagerie générative et les textures
- Déploiement :
@sveltejs/adapter-staticpour le statique,@sveltejs/adapter-vercelpour le SSR
2. Identification de l'Intention (Pré-Ressource)
Avant de charger les références, classez la requête selon trois dimensions. Cela façonne chaque décision de conception ultérieure.
A. Type de Produit
Identifiez ce qui est construit. Chaque type de produit implique des normes de style, de couleur et de mise en page.
| Catégorie de Produit | Styles Recommandés | Direction de Couleur |
|---|---|---|
| SaaS / B2B / Productivité | Grille Suisse, Plat + Vitromorphisme | Bleu de confiance + contraste d'accent |
| E-commerce / Commerce de Détail | Bloc Vibrant, Vitrine Riche en Fonctionnalités | Primaire de marque + vert succès |
| E-commerce de Luxe | Verre Liquide, Cinématique | Neutres foncés + accent or/champagne |
| Fintech / Crypto | Dense en Données, Mode Sombre OLED | Bleu marine/charcoal profond + accent néon |
| Santé / Bien-être | Flux Organique, UI Doux | Sarcelle/sauge doux + neutre chaud |
| Créatif / Portfolio | Néo-Brutaliste, Typographie Cinétique | Contraste élevé + un accent audacieux |
| Jeux / Divertissement | Cyberpunk, HUD/Sci-Fi | Très foncé + multi-accent néon |
| Éducation / Documentation | Broadsheet Éditorial, Minimal | Papier chaud + hiérarchie d'encre |
| Plateforme IA / ML | UI Aurore, Piloté par le Mouvement | Primaire dégradé + surface foncée |
| Tableau de Bord / Analytique | Grille Bento, Dense en Données | Surface neutre + couleurs de données sémantiques |
Utilisez ce tableau comme une boussole de départ, pas une contrainte. Personnalisez toujours.
B. Intention de Style
Déterminez la cible esthétique à partir des indices contextuels, de la demande explicite ou du type de produit. Voir references/landing-pages.md Section 3 pour 8 styles intemporels avec spécifications complètes.
C. Public et Contexte
Considérez qui utilise cela et où. Les publics d'entreprise tolèrent la densité ; les publics consommateurs ont besoin d'espace de respiration. Le mobile-first change tout en ce qui concerne les cibles tactiles, l'échelle typographique et l'intensité des animations.
3. Protocole de Chargement des Ressources
Après avoir identifié l'intention, analysez la requête pour les mots-clés déclencheurs. Chargez les fichiers de référence correspondants depuis references/ pour accéder aux modèles d'implémentation profonds.
Pages d'Atterrissage et Sections Hero
Déclencheurs : "page d'atterrissage", "hero", "au-dessus de la ligne de flottaison", "page d'accueil", "titre du site", "titre principal", "CTA", "appel à l'action", "conversion", "première impression"
Charger : references/landing-pages.md
Fournit : Anatomie de la section Hero, 8 styles de page d'atterrissage intemporels (Keynote Apple, Broadsheet Éditorial, Terrain de Jeu Géométrique, Immersif Cinématique, Grille Suisse, Néo-Brutaliste, Flux Organique, Terminal Rétro), motifs de flux visuel (Z/F/Golden/Diagonal), architecture de conversion, stratégie hero mobile-first, modèles de code.
Typographie et Sélection de Polices
Déclencheurs : "police", "typographie", "police de caractères", "titre", "style de texte", "appariement de polices", "échelle de type", "espacement des lettres", "hauteur de ligne", "lisible", "police d'affichage"
Charger : references/typography.md
Fournit : Catalogues de polices d'affichage/corps/mono avec recommandations d'appariement, construction d'échelle de type (ratios mathématiques), typographie responsive avec clamp(), polices variables, chargement et performance des polices, détails typographiques (crénage, ponctuation suspendue, alignement optique), la checklist de lisibilité.
Système de Couleurs et Thématisation
Déclencheurs : "couleur", "palette", "thème", "mode sombre", "mode clair", "accent", "schéma de couleurs", "couleurs de marque", "contraste", "teinte", "saturation"
Charger : references/color-system.md
Fournit : Architecture de palette structurée en 3 groupes (Tons de Base, Tons Primaires, Tons d'Accent), modèles d'harmonie de la théorie des couleurs, flux de travail de génération de palette, construction du thème clair, construction du thème sombre (règles indépendantes), sélecteur de thème avec thèmes bonus (variantes chaud/froid/mono/contraste élevé), jetons de couleur sémantiques, système de propriétés personnalisées CSS, conformité WCAG de contraste.
Imagerie, Textures et Arrière-plans
Déclencheurs : "image", "arrière-plan", "texture", "photo", "illustration", "tramage", "superposition", "arrière-plan parallaxe", "image hero", "Nano Banana", "duotone", "motif"
Charger : references/imagery.md
Fournit : Taxonomie des rôles d'image, stratégie de dimensionnement et de format, composition d'arrière-plan en trois couches, algorithmes de tramage (Atkinson/Floyd-Steinberg/Bayer), délimitation géométrique et superposition (lignes diagonales, formes clip-path, marques de coin, superpositions de grille), mouvement dans l'imagerie, sélection de style artistique (photorealiste/illustré/génératif/média mixte/duotone), imagerie de boutons et bannières, intégration Nano Banana, guide de génération d'images IA.
Graphiques de Données, Tableaux, Diagrammes et Infographies
Déclencheurs : "tableau", "diagramme", "infographie", "données", "statistiques", "métriques", "KPI de tableau de bord", "comparaison", "chronologie", "flux de processus", "affichage de nombre"
Charger : references/data-graphics.md
Fournit : Conception de tableaux au-delà des valeurs par défaut (tableaux sans grille, indicateurs de statut, cellules sparkline, en-têtes collants, techniques d'emphase), esthétique des diagrammes et narration (remplissages dégradés, effets de lueur, annotations, remplacements de grille), intégration de diagrammes Mermaid, motifs infographiques (blocs de nombres, chronologies, grilles de comparaison, flux de processus), génération de prompts IA pour visuels de données, graphiques prêts pour l'impression.
Micro-animations et Contrôles Interactifs
Déclencheurs : "animation", "survol", "clic", "bouton", "bascule", "retour", "ondulation", "chargement", "squelette", "transition", "accrochage", "magnétique", "animation de défilement", "micro-interaction", "contrôle responsive", "transition d'état", "animation de formulaire"
Charger : references/microanimations.md
Fournit : Système complet de bouton à 5 états (par défaut/survol/actif/focus/désactivé), retour de navigation (éléments de menu, hamburger, indicateur d'onglet), animations pilotées par le défilement (révélation échelonnée, barre de progression, animation de compteur), interactions de formulaire (étiquettes flottantes, retour de validation, cases à cocher personnalisées), états de chargement (squelettes, succès/erreur), transitions de page, motifs de sensation haptique (pression, rebond, soulèvement de carte, ondulation), comportements d'accrochage et magnétiques, règles de performance, tableau de référence des courbes d'assouplissement et de temporisation.
Mouvement Visuel et Profondeur
Déclencheurs : "3d", "profondeur", "parallaxe", "inclinaison", "faux 3d", "spatial", "cinétique", "mouvement", "vitromorphisme", "holographique"
Charger : references/visual-kinetics.md
Fournit : Système de niveaux d'animation (CSS -> Svelte -> Svelte Motion -> GSAP), carte d'inclinaison holographique avec éblouissement, hero parallaxe avec couches Nano Banana, vitromorphisme 2.0, typographie cinétique (masque de révélation, marquee, texte fractionné), révélations déclenchées par le défilement, assouplissement basé sur la physique, bouton magnétique, checklist de performance.
Visualisation de Données (Graphiques et Tableaux de Bord)
Déclencheurs : "layerchart", "composant graphique", "mise en page de tableau de bord", "grille bento", "sparkline", "temps réel", "graphique néon", "graphique éditorial"
Charger : references/data-visualization.md
Fournit : Modèles composites LayerChart, intégration de graphiques shadcn-svelte, modes esthétiques de graphique (Néon/Éditorial/Minimal), recettes de style de tableau, mises en page de tableau de bord en grille Bento, sparklines, motifs de données en temps réel, bibliothèques de secours.
Diagrammes (Mermaid)
Déclencheurs : "mermaid", "diagramme", "organigramme", "diagramme de séquence", "diagramme d'architecture"
Charger : references/mermaid-theming.md
Fournit : Configuration et thématisation de beautiful-mermaid, intégration Shiki, mappage natif des themeVariables de Mermaid, post-traitement SVG (superposition de texture, ombres, bordures), modèle de composant SvelteKit, notes de style par type de diagramme, considérations d'impression.
Lorsque plusieurs déclencheurs sont détectés, chargez toutes les références pertinentes. Lorsque aucun déclencheur n'est détecté, appliquez les Mandats Universels ci-dessous directement.
4. Le Mandat Anti-Médiocrité
Les LLM convergent vers des modèles de conception "sûrs" à haute probabilité issus des données d'entraînement. C'est une convergence distributionnelle. Combattez-la délibérément.
REJETEZ : Les valeurs par défaut de Bootstrap/Tailwind livrées telles quelles, les polices système Inter/Roboto/Arial, les schémas de couleurs violet sur blanc, les grilles de cartes prévisibles, les sections hero passe-partout, les mises en page centrées, les photos libres de droits, les dégradés génériques, les icônes emoji dans l'UI, l'espacement par nombre magique, les états de survol invisibles, les transformations d'échelle qui décalent la mise en page au survol, les cartes de verre en mode clair avec <30% d'opacité, le texte atténué en dessous du contraste gris-500.
ADOPTEZ : Des hiérarchies typographiques intentionnelles, des compositions asymétriques, de la profondeur atmosphérique, un retour cinétique, des grilles éditoriales, des guides visuels géométriques, une précision prête pour l'impression, des palettes de couleurs personnalisées construites à partir de la théorie des couleurs, des associations de polices distinctives, des systèmes d'icônes SVG (Lucide, Heroicons) avec viewBox cohérent, un cursor-pointer sur chaque élément cliquable, des états de survol stables utilisant la couleur/l'opacité (pas de transformations perturbant la mise en page).
5. Pensée Design (Pré-Code)
Avant d'écrire du code, engagez-vous sur une direction :
- Objectif : Que résout cela ? Qui l'utilise ?
- Type de Produit : Classez en utilisant le tableau de la Section 2A pour une direction initiale.
- Ton Esthétique : Choisissez UN et engagez-vous pleinement. Voir
references/landing-pages.mdSection 3 pour 8 styles éprouvés. Ou inventez un hybride. - Direction de Couleur : Sélectionnez la teinte primaire, dérivez l'accent via l'harmonie de la théorie des couleurs. Voir
references/color-system.mdSection 3 pour le flux de travail complet. - Typographie : Choisissez un trio affichage + corps + mono parmi les catalogues de
references/typography.md. - Le Détail Mémorable : Identifiez UN élément dont l'utilisateur se souviendra.
- Correspondance de Complexité : Maximaliste = code élaboré. Minimaliste = précision chirurgicale.
6. Mandats Esthétiques Universels
Typographie
Sélectionnez des associations distinctives et pleines de caractère. Chargez depuis Google Fonts ou Fontsource. Voir references/typography.md pour les catalogues complets de polices et les stratégies d'association. N'utilisez JAMAIS Inter, Roboto, Open Sans, Lato, ou les polices système par défaut sauf si elles sont fortement modifiées. Ne convergez JAMAIS vers Space Grotesk entre les générations.
Couleur (La Palette Structurée)
Construisez une palette en 3 groupes : Tons de Base, Tons Primaires, Tons d'Accent. Voir references/color-system.md pour le système complet. Thèmes clairs : ombres marquées, typographie lourde, lignes fines. Thèmes sombres : lueurs colorées, texte blanc cassé (#E8E8E8), dégradés de surface subtils. N'utilisez JAMAIS le violet pur (H : 270-280) comme primaire. Déplacez-vous vers l'indigo, le sarcelle, le corail ou l'émeraude.
Imagerie et Texture
N'utilisez jamais d'arrière-plans plats unis pour les sections hero. Voir references/imagery.md pour la technique de composition en trois couches, les algorithmes de tramage et les motifs d'intégration Nano Banana.
Micro-animations (Obligatoire)
Chaque élément interactif doit fournir un retour de mouvement. Voir references/microanimations.md pour le système complet de bouton à 5 états, les animations pilotées par le défilement et les motifs de sensation haptique.
Composition Spatiale
Échafaudage vertical, asymétrie, espace négatif, éléments cassant la grille. Voir references/landing-pages.md Section 4 pour les motifs de flux visuel.
Accessibilité (Non-Négociable)
- HTML sémantique :
<article>,<section>,<nav>,<aside>,<main> - États de focus : JAMAIS
outline: none. Stylisez commeoutline: 2px solid var(--accent); outline-offset: 4px - Contraste minimum WCAG AA. Voir
references/color-system.mdSection 9. - Étiquettes ARIA sur tous les composants interactifs personnalisés
prefers-reduced-motion: désactiver la parallaxe, l'inclinaison, les animations complexes- La couleur ne doit jamais être le seul indicateur d'état
- Toutes les images ont besoin de texte alternatif ; les entrées de formulaire ont besoin d'étiquettes
Impression et PDF
Les sites doivent pouvoir également servir de rapports imprimables lorsque @media print est actif. Cachez la navigation/pied de page/boutons, forcez le fond blanc, conservez les graphiques SVG, utilisez break-inside: avoid sur les cartes/graphiques/tableaux.
7. Flux de Travail d'Implémentation
- Identifiez : Classez le type de produit, l'intention de style, le public (Section 2).
- Chargez : Analysez les déclencheurs de ressources. Chargez les fichiers de référence pertinents (Section 3).
- Recherchez : Pour les constructions complexes, effectuez des recherches approfondies (jusqu'à 10 recherches Web) sur des sites primés comparables, des motifs et les capacités des bibliothèques.
- Architectez : Planifiez la structure de fichiers SvelteKit. Définissez les jetons de variables CSS.
- Codez : Écrivez du HTML sémantique, du Tailwind étendu, des Runes Svelte 5. Prêt pour la production, pas de placeholders.
- Peaufinez : Appliquez des micro-animations, des couches de texture, des états de survol, des déclencheurs de défilement.
- Validez : Exécutez la Checklist Pré-Livraison (Section 8). Corrigez tous les échecs.
- Itérez : Comparez avec la vision esthétique. Ajustez jusqu'à ce que cela claque.
8. Checklist Pré-Livraison
Exécutez ceci avant de livrer tout code UI. Chaque élément est un mode de défaillance connu.
Qualité Visuelle
- Aucun emoji utilisé comme icône UI (utilisez les SVG Lucide ou Heroicons)
- Toutes les icônes d'un ensemble cohérent unique avec viewBox correspondant (24x24)
- Logos de marque vérifiés par rapport aux sources officielles (Simple Icons)
- Les états de survol ne provoquent AUCUN décalage de mise en page (utilisez opacité/couleur, pas de transformations d'échelle)
- Aucune classe de couleur Tailwind par défaut sans personnalisation
- L'association typographique est intentionnelle et chargée (pas de repli système)
Interaction
- Chaque élément cliquable a
cursor-pointer - Chaque élément interactif a un retour de survol visible
- Les transitions utilisent une durée de 150 à 300 ms (jamais >500 ms pour l'UI, jamais 0 ms)
- Les états de focus sont visibles et stylisés (pas de valeurs par défaut du navigateur, jamais supprimés)
- Les cibles tactiles font au moins 44x44px sur mobile
Mode Clair/Sombre
- Mode clair : le contraste du texte passe WCAG AA (rapport de contraste >= 4.5:1 pour le texte normal, >= 3:1 pour le texte grand)
- Mode sombre : le texte est blanc cassé (#E8E8E8 ou plus clair), pas du blanc pur (#FFFFFF)
- Les deux modes définissent les 3 groupes : Tons de Base, Tons Primaires, Tons d'Accent
- Les deux modes chargent l'image de fond correcte (pas seulement l'inverser)
- Le commutateur de thème persiste via localStorage ou préférence système
Performance
- Pas de décalage de mise en page lors du chargement des polices (utilisez
font-display: swap+ taille de repli) - Les images ont
loading="lazy"sauf au-dessus de la ligne de flottaison - Les animations utilisent uniquement
transformetopacity(pas de propriétés coûteuses commewidth,height,top) -
will-changeappliqué uniquement aux éléments animés, pas globalement - Pas d'images raster volumineuses comme arrière-plans (utilisez le chargement progressif ou les dégradés CSS)
Code
- Runes Svelte 5 :
$state,$derived,$effectcorrectement typées et scoped - Aucune variable CSS magique (toutes définies via le système de jetons)
- Composants décomposés avec une seule responsabilité
- Gestion d'état cohérente (stores ou Runes, pas les deux)
- Pas de code mort ou de commentaires en production
Accessibilité
- Navigation au clavier logique (tabindex, ordre de tabulation)
- Tous les lecteurs d'écran : les éléments décoratifs ont
aria-hidden="true" - Tous les lecteurs d'écran : les éléments informatifs sont décrits
-
prefers-reduced-motionrespecté (parallaxe, inclinaison, animations complexes désactivés) - Images : texte alternatif significatif (pas "image", pas vide pour les images décoratives)
- Formulaires : étiquettes associées aux entrées, messages d'erreur lisibles
Impression
- Navigation, pied de page, boutons interactifs masqués dans @media print
- Arrière-plan forcé en blanc, texte en noir
- Graphiques et diagrammes conservés (pas masqués en raison du mode sombre)
-
break-inside: avoidsur les cartes, les graphiques et les tableaux - URL des liens affichées entre parenthèses à côté du texte du lien
9. Références du Projet
Cette compétence charge des fichiers de référence depuis le répertoire references/. Chaque fichier contient des modèles d'implémentation profonds, des catalogues et des motifs pour des décisions de conception spécifiques. Les fichiers actuellement référencés incluent :
references/landing-pages.md- Anatomie de section Hero, 8 styles de page d'atterrissage, motifs de flux visuel, architecture de conversionreferences/typography.md- Catalogues de polices d'affichage/corps/mono, échelles de type, techniques de typographie responsive, checklist de lisibilitéreferences/color-system.md- Architecture de palette en 3 groupes, modèles d'harmonie des couleurs, directives de construction de thème clair/sombre, jetons de couleur sémantiques, conformité WCAGreferences/imagery.md- Composition d'arrière-plan en trois couches, algorithmes de tramage, motifs d'intégration Nano Banana, guide de génération d'images IAreferences/data-graphics.md- Motifs de conception de tableaux, esthétique des diagrammes, intégration Mermaid, motifs infographiquesreferences/microanimations.md- Système de bouton à 5 états, animations pilotées par le défilement, interactions de formulaire, motifs de sensation haptiquereferences/visual-kinetics.md- Système de niveaux d'animation, carte d'inclinaison holographique, hero parallaxe, vitromorphisme 2.0, typographie cinétiquereferences/data-visualization.md- Modèles composites LayerChart, intégration de graphiques shadcn-svelte, modes esthétiques, motifs Bento gridreferences/mermaid-theming.md- Configuration et thématisation de beautiful-mermaid, intégration Shiki, conseils de style par diagramme
10. Philosophie du Design
L'Intention Triomphe de l'Algorithmique
Le design n'est pas une optimisation. C'est une conviction. Chaque pixel, chaque espacement, chaque rapport de contraste doit exister parce que vous avez choisi de le mettre là. Le modèle par défaut est un ennemi. La distribution est un piège.
Les Contraintes Libèrent
Ce système n'est pas une cage. C'est une rampe de lancement. En définissant des mandats clairs (pas de polices système, pas de dégradés génériques, pas de survols invisibles), vous êtes libre de vous concentrer sur ce qui compte : créer quelque chose d'inoubliable.
La Cohérence n'est pas l'Uniformité
Un système de design doit respirer. La palette de couleurs s'adapte au contexte. La typographie change de ton. Les animations s'ajustent à l'ambiance. Mais les principes sous-jacents (intention, précision, caractère) restent inébranlables.
L'Accessibilité est le Design
Ce n'est pas une checklist après coup. L'accessibilité fait partie intégrante de chaque décision : contraste, navigation au clavier, mouvement réduit, HTML sémantique. Un site inaccessible est un site cassé.
La Performance est une Fonctionnalité
Les animations fluides, le chargement instantané des polices, les images paresseuses ne sont pas des bonus. Ce sont des exigences. Chaque milliseconde compte. Chque kilooctet compte.
Atelier de Design Frontend v2.1 — Construit avec intention. Livré avec précision.