Communitygithub.com

design-tokens

Créez un système visuel de site web sous forme de propriétés personnalisées CSS, couvrant palette de couleurs, échelle typographique, espacement, coins arrondis et ombres, avec vérification des contrastes.

Qu'est-ce que design-tokens ?

Cette compétence permet de créer un système design cohérent pour un site web en définissant des 'design tokens' (jetons de conception) sous forme de variables CSS personnalisées. Elle couvre la palette de couleurs (avec des rôles fonctionnels comme `--bg`, `--text`, `--accent`), une échelle typographique fluide utilisant `clamp()`, un système d'espacement, de coins arrondis et d'ombres. L'outil intègre des règles de contraste WCAG (rapport minimum de 4.5:1 pour le texte secondaire, 7:1 pour le texte principal) et propose une vérification automatisée via la CLI `webcraft` ou un script Python. Elle est idéale pour répondre aux demandes de création de thème, de palette de couleurs, de mode sombre, de refonte graphique, ou pour démarrer un projet sans styles prédéfinis. Le résultat est un fichier `tokens.css` structuré avec un bloc `:root` et un bloc optionnel pour le mode sombre, accompagné d'un tableau récapitulatif des rôles.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/HEAD/skills/design-tokens

Demander à votre IA préférée

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

Documentation

Design tokens

Un petit ensemble de valeurs nommées, utilisées partout, est ce qui donne à un site une apparence conçue plutôt qu'assemblée. Définissez les jetons avant les composants ; modifier une marque plus tard revient alors à modifier un seul bloc.

Que demander

Une couleur de marque principale (ou un mot d'ambiance), une base claire ou sombre, et le ton (corporate, ludique, éditorial, technique). Tout le reste peut en découler.

Couleur

Travaillez par rôles, et non par noms de couleurs, afin qu'un changement de marque n'exige pas de renommage.

JetonRôleRègle empirique
--bgFond de pageBlanc cassé ou presque noir, jamais du #fff ou #000 pur
--surfaceCartes, champs de saisie2 à 4% d'écart de luminosité par rapport à --bg
--textTexte principalAu moins 7:1 par rapport à --bg
--mutedTexte secondaireAu moins 4.5:1 par rapport à --bg
--borderFilets10 à 15% de la couleur du texte mélangé au fond
--accentBoutons, mises en évidenceLa couleur de la marque
--accent-inkLiens et texte d'accentuation sur --bgLa couleur de la marque, assombrie (ou éclaircie sur fond sombre) jusqu'à passer le 4.5:1
--on-accentTexte sur l'accentLa couleur, blanche ou foncée, qui passe le 4.5:1

Conseils :

  • Teintez légèrement les neutres vers la teinte d'accentuation (2 à 6% de saturation). Des gris purs à côté d'un accent chaud semblent sans lien.
  • Utilisez l'accent sur environ 10% de la surface. Si tout est accentué, rien ne l'est.
  • Un second accent est rarement nécessaire. Ajoutez-en un seulement pour une signification distincte, comme le succès ou une promotion.
  • Pour le mode sombre, n'inversez pas. Augmentez la luminosité de la surface à mesure que l'élévation augmente et réduisez un peu la saturation de l'accent pour qu'il ne brille pas.

Si l'interface en ligne de commande webcraft est disponible, générez un ensemble de départ plutôt que de dériver les valeurs manuellement. Il applique toutes les règles ci-dessus, résout la luminosité jusqu'à ce que chaque paire réussisse, et construit le thème sombre séparément :

webcraft tokens "#e4572e" --tone editorial -o tokens.css      # aussi : --base dark, --radius pill
webcraft tokens "#e4572e" --format theme-json                 # WordPress theme.json avec les mêmes valeurs

Dans un client MCP, la même chose est réalisée avec l'outil generate_tokens. Traitez la sortie comme une première ébauche : ajustez à l'œil, puis revérifiez.

Vérifiez chaque paire de texte et de fond avant de finaliser :

webcraft contrast "#1b1b1f" "#f6f4ef"
webcraft contrast --tokens tokens.css
python scripts/contrast.py --tokens tokens.css   # solution de secours sans installation, valeurs hex uniquement

La première forme imprime le rapport et les niveaux WCAG pour une paire. La seconde lit un fichier CSS et vérifie les paires de rôles standard dans chaque bloc de thème (:root, [data-theme], prefers-color-scheme), en résolvant var() et en lisant les valeurs hexadécimales, rgb(), hsl(), oklch() et color-mix(). Les paires défaillantes sont le défaut d'accessibilité le plus courant sur les nouveaux sites, et elles sont invisibles pour les personnes ayant une bonne vision sur un bon écran, c'est pourquoi il s'agit d'un script et non d'un jugement subjectif.

Typographie

  • Deux familles au maximum : une pour les titres, une pour le corps de texte. Une seule famille en deux graisses est souvent préférable.
  • Associez par contraste de structure (sérif pour l'affichage avec un sans-sérif pour le corps, ou un condensé pour l'affichage avec un corps régulier), et non deux sans-sérif similaires.
  • Taille du corps de 16 à 18 px, hauteur de ligne de 1,5 à 1,7, longueur de ligne de 60 à 75 caractères.
  • Police d'affichage : hauteur de ligne de 0,95 à 1,1, crénage négatif qui augmente avec la taille.
  • Échelle fluide avec clamp() pour qu'il n'y ait pas de sauts entre les points de rupture :
:root {
  --step--1: clamp(0.83rem, 0.8rem + 0.15vw, 0.9rem);
  --step-0:  clamp(1rem, 0.95rem + 0.25vw, 1.125rem);
  --step-1:  clamp(1.25rem, 1.1rem + 0.6vw, 1.6rem);
  --step-2:  clamp(1.6rem, 1.3rem + 1.3vw, 2.4rem);
  --step-3:  clamp(2rem, 1.5rem + 2.6vw, 3.6rem);
  --step-4:  clamp(2.5rem, 1.6rem + 4.6vw, 5.5rem);
  --step-5:  clamp(3rem, 1.5rem + 7vw, 7.5rem);
}
  • Chargez les polices avec font-display: swap, préchargez le ou les deux fichiers utilisés au-dessus de la ligne de flottaison, et créez des sous-ensembles si vous les hébergez vous-même.

Espacement, coins arrondis, ombre

:root {
  --space-1: 0.25rem; --space-2: 0.5rem; --space-3: 0.75rem; --space-4: 1rem;
  --space-6: 1.5rem;  --space-8: 2rem;   --space-12: 3rem;   --space-16: 4rem;
  --section: clamp(4rem, 3rem + 6vw, 9rem);   /* espacement vertical entre les sections */
  --gutter:  clamp(1rem, 0.5rem + 3vw, 3rem); /* remplissage latéral de la page */
  --container: 76rem;

  --radius-sm: 8px; --radius: 16px; --radius-lg: 28px; --radius-pill: 999px;
  --shadow: 0 1px 2px rgb(0 0 0 / .04), 0 8px 24px rgb(0 0 0 / .06);
}
  • Choisissez une personnalité de coin (carré, doux ou pilule) et tenez-vous-y. Des coins arrondis mixtes sont le moyen le plus rapide de paraître incohérent.
  • L'espacement entre les sections doit être nettement plus grand que l'espacement à l'intérieur de celles-ci ; cet écart indique à l'œil où une section se termine.

Résultat

Fournissez un seul fichier tokens.css avec un bloc :root, un bloc optionnel [data-theme="dark"], et un court tableau indiquant quel jeton est utilisé où. Indiquez ensuite les résultats de contraste pour le texte principal, le texte secondaire et le texte des boutons.

Rebranding d'un site existant

Commencez par associer les valeurs codées en dur existantes aux rôles (recherchez les codes hexadécimaux dans le CSS et comptez les occurrences), remplacez-les par des jetons, vérifiez que rien n'a changé visuellement, puis échangez les valeurs des jetons. Faire les deux à la fois rend les régressions impossibles à tracer.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

launch-qa

Run a pre-launch quality check on a website covering performance, accessibility, SEO basics, forms, cross-device behavior and content, and report findings ranked by severity with fixes. Use this whenever someone says a site is "ready to launch", "going live", asks "can you check my site", wants a QA pass, a website audit, a Lighthouse-style review, or wants to know why a page is slow or scoring badly.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

scroll-motion

Add scroll-driven and entrance animation to a website with GSAP, ScrollTrigger and Lenis, including reveals, parallax, pinned sections, horizontal scroll, line drawing, counters and preloaders. Use this whenever someone wants a site to "feel premium", asks for smooth scrolling, scroll animations, parallax, text reveals, a pinned or sticky scroll section, an animated preloader, or names GSAP, ScrollTrigger, Lenis, Locomotive or AOS.

site-teardown

Analyze a live website and turn it into a section-by-section build brief that another person or AI can rebuild from, with brand name, colors, fonts and images swapped for placeholders. Use this whenever someone shares a URL and says "analyze this site", "make something like this", "give me a prompt to build this", "recreate this effect", "clone the layout with my branding", or asks how a page's animation or structure works, even if they never say "teardown".

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

wordpress-theme-build

Turn a static HTML/CSS/JS design into a custom WordPress theme that the client can edit, covering theme structure, theme.json, enqueueing scripts, block patterns, custom post types and editable content. Use this whenever someone wants to convert a design or static site to WordPress, build a custom or block theme, make sections editable in Gutenberg, add GSAP or other scripts to a theme properly, or asks why their theme edits are lost or their content is hard-coded.

Skills associés