Déterminez d'abord l'artefact dont vous avez besoin. Un thème visuel modifie des valeurs telles que les couleurs, les polices, les rayons de bordure et les ombres. Un design system prêt pour l'implémentation relie ces valeurs à des rôles sémantiques et des règles d'utilisation. Un transfert vers un agent de code place ces règles et tokens là où un agent peut les lire ou les installer. Ces catégories se chevauchent. Elles décrivent l'artefact livré, et non sa qualité.
Ce que livrent les outils observés
Les outils observés utilisent des labels similaires pour des sorties différentes. L'offre officielle de shadcn/ui fournit des composants en code ouvert personnalisables et une interface composable commune. Shadcn Design génère du CSS pour les thèmes clair et sombre à partir d'une seule couleur primaire. Shadcn Studio ajoute un éditeur de thèmes plus complet avec des contrôles, des aperçus, des préréglages et des options d'installation. Identity Forge package des tokens sémantiques avec des directives de design écrites et des artefacts de livraison pour agents.
La comparaison utilise quatre états de preuve. « Documenté » signifie qu'une source figée établit la capacité. « Partiel » signifie que la source établit une capacité plus restreinte, avec la limite précisée. « Non documenté » signifie que les preuves disponibles ne l'établissent pas, ce qui ne constitue pas une preuve d'absence. « Non applicable » concerne un champ qui ne correspond pas à l'artefact.
shadcn/ui officiel
- Rôles sémantiques : non documentés. Les pages citées établissent l'existence de composants personnalisables et de code ouvert, mais pas de contrat de sortie pour les tokens sémantiques.
- Sortie clair et sombre : non documentée. La page d'accueil inclut des images d'interface claire et sombre, mais cela ne documente pas le contenu d'un thème généré ou distribué.
- Contrôles typographiques : non documentés. Les preuves citées n'établissent pas de contrôles typographiques comme faisant partie d'un contrat de sortie.
- Directives d'espacement et de mise en page : non documentées. Les preuves citées n'établissent pas de règles d'espacement ou de mise en page exportées.
- Directives de composants : partielles. Les sources documentent des composants en code ouvert personnalisables et une interface composable commune, mais pas de règles d'utilisation du design exportées.
- Aperçus : partiels. La page d'accueil montre des surfaces d'interface représentatives, mais les preuves n'établissent pas de flux de travail interactif pour le thème ou l'aperçu de l'export.
- Forme d'export ou de livraison : documentée. La documentation décrit un code de composant ouvert distribué via un schéma de fichiers plats et une CLI.
- Livraison via registre : non documentée. Les extraits cités n'établissent pas ce mode de livraison.
- Documentation lisible par un agent : partielle. L'introduction indique que les modèles d'IA peuvent lire le code ouvert et l'API cohérente, mais elle n'établit pas de document distinct pour les règles de design.
Shadcn Design
- Rôles sémantiques : non documentés. La page documente des variables CSS générées mais n'expose pas suffisamment la sortie pour vérifier un ensemble de rôles basés sur la sémantique.
- Sortie clair et sombre : documentée. Le générateur indique qu'il crée les deux modes à partir d'une seule couleur primaire.
- Contrôles typographiques : documentés. La page propose des choix de polices distincts pour le corps de texte et les titres.
- Directives d'espacement et de mise en page : non documentées. La page n'établit pas de règles écrites d'espacement ou de mise en page.
- Directives de composants : non documentées. Les écrans d'aperçu stylisés n'établissent pas d'instructions d'utilisation des composants exportées.
- Aperçus : documentés. Le générateur fournit des aperçus en direct pour les pages de destination, les tableaux de bord et les graphiques.
- Forme d'export ou de livraison : documentée. Il copie des variables CSS Tailwind v4 couvrant les couleurs, les polices, les rayons et les ombres.
- Livraison via registre : non documentée. La page citée n'établit pas l'installation via un registre pour le thème généré.
- Documentation lisible par un agent : non documentée. Les preuves n'établissent pas de brief de design ou d'autre document de règles livré avec le thème.
Shadcn Studio
- Rôles sémantiques : partiels. Le générateur documente des contrôles nommés, notamment « primary » et « destructive », mais les preuves n'établissent pas un inventaire complet des rôles sémantiques.
- Sortie clair et sombre : documentée. Le générateur documente la personnalisation et l'export du thème shadcn au sein de son flux de travail.
- Contrôles typographiques : documentés. Sa documentation inclut un onglet typographie.
- Directives d'espacement et de mise en page : non documentées. Les pages citées n'établissent pas de règles d'espacement ou de mise en page exportées.
- Directives de composants : non documentées. Les aperçus en temps réel montrent des effets visuels, mais les preuves n'établissent pas de règles d'utilisation des composants écrites dans l'export.
- Aperçus : documentés. Le générateur fournit des aperçus en temps réel pour les composants, les blocs et les templates.
- Forme d'exportation ou de livraison : documentée. Les sources décrivent un résultat copié, une configuration manuelle et un itinéraire via registre.
- Livraison via registre : documentée. La documentation identifie l'installation via registre comme une option Pro et la configuration manuelle comme une autre voie.
- Documentation lisible par un agent : non documentée. La génération de thèmes assistée par IA est documentée, mais cela diffère de l'exportation de règles destinées à un autre agent de code.
Identity Forge
- Rôles sémantiques : documentés. Identity Forge documente 28 rôles de couleurs basés sur le sens pour les deux modes, ainsi que des exports CSS, Tailwind et DTCG.
- Résultats clair et sombre : documentés. Le guide des tokens sémantiques et les preuves du kit public décrivent des valeurs distinctes pour les modes clair et sombre.
- Contrôles typographiques : documentés. Les données du kit public incluent les rôles typographiques, les familles, les graisses et un libellé d'échelle.
- Guidage sur l'espacement et la mise en page : documenté. Le guide DESIGN.md indique que ses briefs générés incluent des règles d'espacement et de mise en page.
- Guidage sur les composants : documenté. Le guide DESIGN.md décrit les traitements des composants et les contraintes d'utilisation explicites dans le brief écrit.
- Aperçus : documentés. Les pages du kit public présentent les kits sur des surfaces d'interface représentatives.
- Forme d'exportation ou de livraison : documentée. Les sources du produit décrivent DESIGN.md ainsi que les formats de tokens CSS, Tailwind, shadcn et DTCG.
- Livraison via registre : documentée. Les guides officiels documentent l'installation du registre shadcn parallèlement aux voies CLI et MCP.
- Documentation lisible par un agent : documentée. DESIGN.md fournit des directives écrites liées aux tokens du kit.
Il n'y a pas de vainqueur universel dans ce comparatif. Un générateur spécialisé est plus adapté lorsqu'un projet shadcn existant a seulement besoin de nouvelles variables visuelles et d'un aperçu. Des règles plus larges deviennent utiles lorsque les développeurs ou les agents doivent prendre de nouvelles décisions d'interface sans avoir à deviner systématiquement le système prévu.
Inspectez un export avant de choisir
Appliquez ce questionnaire à un export réel. Il s'agit d'une inspection réalisée par l'utilisateur, et non d'un benchmark des outils ci-dessus. Utilisez le même contenu d'exemple pour chaque candidat afin que les différences proviennent des artefacts et non de différents écrans de test.
1. Parité des modes et signification des tokens
- Contenu de test : arrière-plan de page, texte standard et atténué, actions primaires et destructives, champ de saisie bordé, contrôle sélectionné et état de focus clavier.
- Inspection : notez si les noms décrivent l'usage (ex: background, foreground, primary, destructive, border, ring) ou seulement des valeurs visuelles. Associez chaque rôle clair à son équivalent sombre.
- Condition d'échec : un composant nécessite une teinte brute car aucun rôle approprié n'existe, un rôle clair n'a pas d'équivalent sombre, ou les états destructif et focus empruntent un rôle sans rapport.
2. Surfaces de composants représentatives
- Contenu de test : boutons primaires et secondaires, champs de saisie désactivés et en erreur, cartes, popovers, navigation, tableau avec lignes sélectionnées et survolées, et graphique avec plusieurs séries.
- Inspection : tracez les couleurs visibles vers les rôles exportés. Vérifiez les paires avant-plan/arrière-plan, les bordures, les indicateurs de focus, les superpositions, les états sélectionnés et les rôles de séries de graphiques.
- Condition d'échec : l'écran nécessite des valeurs improvisées, un seul rôle sert des objectifs contradictoires, ou un état devient indiscernable dans l'un des modes. Notez cela comme une lacune de l'export candidat, et non comme une preuve de l'incapacité totale de l'outil.
3. Rôles typographiques
- Contenu de test : titre de page, titre de section, corps de texte, libellé de formulaire, texte d'aide, valeurs de tableau et, le cas échéant, un champ de code ou d'identifiant.
- Inspection : notez si l'artefact mappe les familles, graisses, tailles, hauteurs de ligne et interlignages vers des rôles nommés, ou s'il fournit uniquement des valeurs de font-family.
- Condition d'échec : les intégrateurs doivent inventer des graisses ou des traitements, un rôle fait référence à une graisse indisponible, ou les valeurs exportées sont en conflit avec les instructions écrites.
4. Espacement, mise en page et directives conservées
- Contenu de test : formulaire étroit, grille de cartes, tableau dense, en-tête de page et navigation responsive.
- Inspection : recherchez des règles couvrant la largeur du contenu, les gouttières, l'espacement des sections, la densité des composants, le comportement de la grille et les changements responsives. Vérifiez si ces règles restent disponibles après l'exportation ou l'installation.
- Condition d'échec : un aperçu suggère une mise en page que l'artefact ne décrit jamais, l'exportation supprime les règles écrites, ou un autre intégrateur doit déduire la densité et la structure à partir des seules images.
Vérifiez le contrat de transfert (handoff)
Un agent de code ne peut utiliser que les directives qui parviennent à son contexte de travail. Avant de qualifier un export de « transfert pour agent », répondez à ces questions pour l'artefact et le projet concernés.
- Hypothèses de framework : Quel contexte shadcn, Tailwind, framework ou bibliothèque de composants est attendu ? Notez les versions si la source les fournit.
- Voie d'installation : Le projet reçoit-il du CSS copié, du code de composant, un bundle appliqué via CLI, un élément de registre, un artefact livré via MCP, ou une combinaison de ces éléments ?
- Mappage tokens-composants : L'intégrateur peut-il identifier les rôles pour les boutons, les champs de saisie, les cartes, les popovers, la navigation, les tableaux, les graphiques, les actions destructives et les états de focus ?
- Choix typographiques : Les familles autorisées, les rôles et les graisses disponibles sont-ils explicites ?
- Règles d'espacement et de mise en page : Le transfert décrit-il l'agencement des pages et des composants, ou seulement les valeurs du thème ?
- Contraintes d'utilisation : Est-il expliqué quand un traitement doit ou ne doit pas être utilisé ?
- Lacunes identifiées : quelles valeurs ou règles nécessitent encore l'arbitrage d'un designer, d'un développeur ou d'un agent ?
Un fichier DESIGN.md n'est utile que si le workflow le place là où l'agent cible peut le lire. Un élément de registre peut installer des valeurs sans nécessairement intégrer le raisonnement écrit dans le même contexte. Inspectez les deux canaux plutôt que de supposer qu'un seul artefact installé contient l'intégralité du handoff.
Exemple concret : Ambient Sage
Le kit public Ambient Sage est un exemple limité d'un handoff plus large. Ses données publiées listent 28 design tokens de couleur sémantique pour les modes clair et sombre. La page fournit également un DESIGN.md et identifie des chemins d'installation, notamment via l'Identity Forge CLI et le registre shadcn. Ce sont des propriétés observées de ce kit, et non la preuve que ses choix visuels conviennent à tout produit.
La typographie publiée assigne Plus Jakarta Sans aux rôles de titres et de corps de texte avec des graisses de 400, 500, 600 et 700. JetBrains Mono occupe le rôle mono avec des graisses de 400, 500 et 700. L'étiquette d'échelle est compact-product. Les sources du projet de police confirment l'existence de ces familles, mais ne démontrent pas que ce couplage, cet ensemble de graisses ou cette échelle soient préférables pour chaque implémentation.
Les preuves publiques identifient l'artefact et sa couverture déclarée. L'adoption nécessite toujours une inspection. Vérifiez si l'export choisi préserve les 28 rôles dans les deux modes, si le projet charge les graisses listées et si le DESIGN.md parvient à la personne ou à l'agent censé le suivre. Tracez ensuite les rôles via les composants de la feuille de travail. Cet article n'a pas effectué de benchmark comparatif.
Choisir l'outil le plus léger possible
- Optez pour un copier-coller de CSS lorsque la tâche consiste en un rafraîchissement visuel et que le projet dispose déjà de règles pour les composants, la typographie, l'espacement et la mise en page.
- Optez pour un éditeur de thème ou un preset réutilisable lorsque les projets shadcn nécessitent des variables visuelles et des aperçus cohérents, alors que les directives produit globales se trouvent ailleurs.
- Optez pour un design system prêt pour l'implémentation lorsque les développeurs ont besoin de rôles sémantiques partagés ainsi que de directives explicites sur la typographie, l'espacement, la mise en page et les composants.
- Optez pour un handoff pour agent de code lorsqu'un constructeur IA doit conserver ces décisions pendant l'implémentation. Vérifiez comment les tokens et les règles écrites sont intégrés dans son contexte.
Prenez un export candidat et passez-le au crible de la feuille de travail avant de l'ajouter au projet. Les décisions non résolues indiqueront si l'artefact actuel est suffisant ou si le travail nécessite un handoff plus complet.
Sources
- The Foundation for your Design System - shadcn/ui : présente des composants en open-code personnalisables et des surfaces d'interface représentatives en modes clair et sombre.
- Introduction - shadcn/ui : documente l'open-code, la composition, le schéma de fichiers plats, la distribution via CLI et une API lisible par les outils d'IA.
- Shadcn Theme Generator | Live Preview, Copy Theme CSS : documente la génération à partir d'une couleur primaire, les thèmes clair et sombre, les contrôles de police, les presets de rayon, les aperçus en direct et la sortie de variables CSS Tailwind v4.
- Design Stunning UIs Faster with Shadcn Theme Generator : documente les presets, la personnalisation en temps réel, les contrôles de typographie et de couleurs nommées, la validation du contraste, les aperçus et l'import/export de thèmes.
- Shadcn Theme Generator Documentation : documente les contrôles de thème, la copie de la sortie, la configuration manuelle et l'installation via le registre Pro.
- Identity Forge : documente des kits contenant des polices, des tokens sémantiques, l'espacement, des directives DESIGN.md, des aperçus et des chemins de livraison pour agents.
- Ambient Sage Design Kit : fournit les preuves publiques pour les tokens sémantiques, les rôles et graisses typographiques, l'étiquette d'échelle compact-product, le DESIGN.md, les exports et les cibles d'installation de l'exemple concret.
- Semantic color tokens explained : documente les 28 rôles sémantiques clair et sombre d'Identity Forge ainsi que les formats d'export CSS, Tailwind et DTCG.
- How to generate a DESIGN.md (and what it is) : documente la couverture du DESIGN.md, incluant l'intention de design, les références de tokens, la typographie, l'espacement, la mise en page, le traitement des composants, les motifs et les contraintes d'utilisation.
- Design systems for AI coding agents : documente la livraison des tokens et du DESIGN.md via MCP, CLI et les routes du registre shadcn.
- Plus Jakarta Sans : fournit la source du projet pour la famille Plus Jakarta Sans citée dans l'exemple Ambient Sage.
- JetBrains Mono : fournit la source du projet pour la famille JetBrains Mono citée dans l'exemple Ambient Sage.
Sources
- The Foundation for your Design System - shadcn/ui: Présente des composants en open-code personnalisables et des surfaces d'interface représentatives en modes clair et sombre.
- Introduction - shadcn/ui: Documente l'open-code, la composition, le schéma de fichiers plats, la distribution via CLI et une API lisible par les outils d'IA.
- Shadcn Theme Generator | Live Preview, Copy Theme CSS: Documente la génération à partir d'une couleur primaire, les thèmes clair et sombre, les contrôles de police, les presets de rayon, les aperçus en direct et la sortie de variables CSS Tailwind v4.
- Design Stunning UIs Faster with Shadcn Theme Generator: Documente les presets, la personnalisation en temps réel, les contrôles de typographie et de couleurs nommées, la validation du contraste, les aperçus et l'import/export de thèmes.
- Shadcn Theme Generator Documentation: Documente les contrôles de thème, la copie de la sortie, la configuration manuelle et l'installation via le registre Pro.
- Identity Forge: Documente des kits contenant des polices, des tokens sémantiques, l'espacement, des directives DESIGN.md, des aperçus et des chemins de livraison pour agents.
- Ambient Sage Design Kit: Fournit les preuves publiques pour les tokens sémantiques, les rôles et graisses typographiques, l'étiquette d'échelle compact-product, le DESIGN.md, les exports et les cibles d'installation de l'exemple concret.
- Semantic color tokens explained: Documente les 28 rôles sémantiques clair et sombre d'Identity Forge ainsi que les formats d'export CSS, Tailwind et DTCG.
- How to generate a DESIGN.md (and what it is): Documente la couverture du DESIGN.md, incluant l'intention de design, les références de tokens, la typographie, l'espacement, la mise en page, le traitement des composants, les motifs et les contraintes d'utilisation.
- Design systems for AI coding agents: Documente la livraison des tokens et du DESIGN.md via MCP, CLI et les routes du registre shadcn.
- Plus Jakarta Sans: Fournit la source du projet pour la famille Plus Jakarta Sans citée dans l'exemple Ambient Sage.
- JetBrains Mono: Fournit la source du projet pour la famille JetBrains Mono citée dans l'exemple Ambient Sage.