StyleRef — appliquer une identité ou un style visuel au canvas Figma
Un StyleRef est une spécification de style structurée — couleurs, typographie, ambiance, lumière, langage formel, matériaux, composition — publiée sur styleref.io et lisible sous forme de texte brut ou JSON. C'est ce qu'une bibliothèque de design n'est pas encore : une description portable d'un look, utilisable avant que des composants n'existent, et utilisable en dehors de Figma dans n'importe quel outil d'IA générant des images.
Ce que fait cette compétence : trouver un style, écrire sa palette et ses règles typographiques dans le fichier sous forme de variables et styles locaux réels, et conserver la spécification complète comme contexte pour que tout ce qui est généré ensuite reste conforme à la marque. Elle lit également une sélection et écrit le style déjà utilisé sous la même forme structurée.
Ce que cette compétence ne fait pas : inventer des règles de marque que l'utilisateur n'a pas données, restyler des calques que l'utilisateur n'a pas sélectionnés, remplacer une bibliothèque de design publiée, ni générer des images par elle-même. Lorsqu'une bibliothèque publiée avec des composants et des variables couvre déjà le look, le dire et utiliser la bibliothèque comme source de vérité.
Quand l'utiliser
- L'utilisateur demande que quelque chose soit conforme à la marque, cohérent ou dans une esthétique nommée.
- L'utilisateur nomme un style, un mouvement artistique ou colle un lien
styleref.io/share/.... - L'utilisateur souhaite une palette et une échelle typographique pour démarrer et n'a pas encore de bibliothèque.
- L'utilisateur souhaite que le look d'une trame existante soit consigné pour être réutilisé — dans ce fichier, dans un autre fichier ou dans un outil d'image IA.
- L'utilisateur explore une expression de marque que les composants ne capturent pas encore.
Voie A — appliquer un style au fichier
Exécuter ceci lorsque l'utilisateur nomme un style ou demande un look que vous devez sourcer.
-
Résoudre le style. Si l'utilisateur a collé un lien
styleref.io/share/{slug}, en extraire le slug. Sinon effectuer une recherche :https://styleref.io/api/v1/styles?query={mots}&limit=5Ajouter
&category={catégorie}pour affiner. Catégories valides : Brand identity, UI/UX, Graphic design, Illustration, Packaging design, Photography, Fine art, 3D visualization, Character design, Cinematography, Game art, Social copy. La réponse donne à chaque correspondance unname,slug,author,palette(liste hex) eturl. Montrer à l'utilisateur 3–5 avec leurs palettes et le laisser choisir. Ne pas choisir à sa place lorsque deux candidats ont des lectures différentes. -
Récupérer la spécification structurée.
https://styleref.io/api/v1/styles/{slug}?format=jsonChaque valeur écrite sur le canvas provient de celle-ci. Récupérer également la forme en prose lorsque vous générerez des trames ou des images par la suite :
https://styleref.io/api/v1/styles/{slug}?format=default&compact=1 -
Écrire les couleurs sous forme de variables locales.
sections.colors.values.color_palette.solidColorsest une liste ordonnée de{hex, amount}.amountest la part prévue de la composition — une proportion, pas un rôle sémantique. Créer une collection nommée d'après le style, et une variable de couleur par hex, ordonnée paramountdécroissant. Proposer des noms de rôles (surface,accent,ink) comme suggestion et préciser qu'ils sont vôtres, pas ceux de la spécification. Appliquer également les règles de couleur non hex —saturation_range,contrast_strategy,gradient_policy,color_temperature,shadow_color— comme contraintes sur tout ce que vous dessinez ; ce ne sont pas des variables.Si
accessibility_levelestWCAG AAouAAA, c'est une exigence, pas une préférence : vérifier les paires texte-sur-fond par rapport à ce ratio lors de leur attribution, et dire quelles paires vous avez vérifiées. Lorsqu'une paire dans la palette ne peut pas l'atteindre, le dire et proposer une correction plutôt que de livrer la paire silencieusement. -
Écrire la typographie sous forme de styles de texte.
sections.typography.values.font_familyest une catégorie ("Display / Decorative", "Geometric Sans"), jamais un nom de police sous licence. Choisir une police concrète déjà disponible dans le fichier, ou l'une des polices par défaut de Figma, et dire à l'utilisateur quelle police vous avez choisie et que la spécification a nommé une catégorie, pas cette police. Ensuite appliquerfont_weights,text_case,letter_spacingettypographic_hierarchyaux styles que vous créez. -
Écrire la couche d'interface à partir de
ui_web. C'est la section qui porte le plus de Figma en elle — trente-trois champs qui sont déjà le vocabulaire de Figma. La lire avant de dessiner une seule trame :color_themeestLightouDark. Un StyleRef porte une palette et donc un thème — il n'y a pas de second ensemble de valeurs pour le mode opposé. Construire une collection mono-thème. Si l'utilisateur souhaite clair et foncé, dire que le style définit un thème et proposer de construire l'autre mode à partir de valeurs fournies par l'utilisateur ; ne jamais le dériver vous-même. Une palette inversée est une marque différente portant le même nom, et l'utilisateur ne peut pas le repérer ensuite.- Les styles plus anciens peuvent encore porter une étiquette double-thème. Faire confiance à la palette, pas à l'étiquette : juger à partir des hex elles-mêmes — celle marquée comme fond de page, ou la dominante par
amount— et dire que le style est mal étiqueté.
- Les styles plus anciens peuvent encore porter une étiquette double-thème. Faire confiance à la palette, pas à l'étiquette : juger à partir des hex elles-mêmes — celle marquée comme fond de page, ou la dominante par
background_tone→ le remplissage de fond de page/canvas.surface_layers→ combien de variables de surface sont nécessaires (Flat= une,Two-layer= page + carte,Three-layer= page + carte + surélevé). Ne pas inventer une quatrième.accent_strategy→ combien de variables d'accent, et si elles sont un accent fonctionnel unique ou un ensemble contextuel.semantic_colors→ variables d'erreur / avertissement / succès / info, seulement au niveau des noms de champs.elevation_approach,shadow_technique,shadow_weight,glass_blur_effect→ les styles d'effet. Ceux-ci remplacent tout ce que vous avez déduit delight_shadow, qui décrit la lumière photographique, pas l'élévation UI.border_philosophy→ traitement de contour par défaut.button_shapeetbutton_hierarchy→ les trames de boutons et leurs variantes.icon_styleeticon_weight→ quel jeu d'icônes utiliser, et à quel poids.navigation_patternetnavigation_style→ le squelette de mise en page de l'écran, etlayout_archetypedit ce qu'est réellement la trame qu'il enveloppe (Dashboard,Feed,Split-screen,Master–detail,Marketing page,Canvas,Wizard / flow).content_widthdéfinit la largeur de la trame et si le contenu est en plein écran ou contenu dans un conteneur.spacing_scaleetdensity→ les nombres d'auto-layout.4pt grid/8pt gridest le pas dont chaque écart et valeur de remplissage est un multiple ;Compact…Spaciousmet à l'échelle quel multiple vous utilisez. Les construire comme variables d'espacement, pas comme des nombres tapés dans chaque trame. Là oùspatial_hierarchyparle également d'espacement ou de densité,ui_webgagne — c'est l'énoncé au niveau de l'interface.corner_radius_scale→ variables de rayon, appliquées à l'échelle du système.button_shapel'affine pour les boutons uniquement ;Mixed by componentsignifie que l'échelle est délibérée par élément, donc énoncer votre correspondance plutôt que de choisir un rayon.card_style→ si le contenu se trouve dans des cartes ou non, et si elles sont bordées, ombrées, teintées ou en verre.input_field_style→ le composant de contrôle de formulaire (Outlined,Filled / tinted,Underline only,Borderless on surface).data_display_styleetdata_viz_style→ ne les construire que lorsque le champ n'est pasNone; ils définissent la densité du tableau, les grilles de graphique, les chiffres KPI et la couleur de série.ui_imagerydit ce qui va dans les emplacements d'image —None (pure UI)signifie les omettre plutôt que de les remplir avec une photographie d'espace réservé.empty_state_style→ une vraie trame que vous dessinez.loading_styleest un comportement : unSkeleton shimmerobtient une trame de squelette statique plus une note, jamais une fausse animation.focus_ring_styleest un artefact d'accessibilité, pas une décoration. Le construire, et ne jamais le supprimer pour rendre un écran plus propre.hover_treatment,animation_philosophy,transition_speedetscroll_behaviordécrivent un comportement, qu'une trame statique ne peut pas contenir. Les enregistrer comme notes sur le canvas ou dans votre réponse — ne pas les simuler comme des styles et ne pas les supprimer silencieusement.
Lorsque
ui_webest absent, le dire et travailler à partir des sections ci-dessous ; ne pas inventer de règles d'interface que le style n'a jamais spécifiées. -
Mapper les sections restantes du canvas. Seules celles-ci se traduisent en objets du fichier :
Section Écrire comme colorsVariables de couleur + règles de remplissage typographyStyles de texte ui_webModes de variable, variables de surface/accent/sémantiques, styles d'effet, boutons, icônes, navigation, anneaux de focus — voir étape 5 container_boundaryRemplissage de trame, traitement des coins, comportement de découpage shape_languageRayon de coin, décisions de géométrie stroke_systemPoids de contour et extrémités spatial_hierarchyGrille et composition — mais ui_webgagne sur l'espacement et la densitélight_shadowStyles d'effet — mais ui_webgagne là où les deux parlentsurface_materialTraitement de remplissage, texture background_environmentArrière-plans de trame guardrailsRègles strictes "ne jamais faire ceci" — les respecter mood_personality,output_format,references,inspiration_imagesetcustom_style_itemsne correspondent pas à des objets du fichier. Les conserver comme contexte pour la génération et pour vos propres jugements. -
Conserver la spécification comme contexte de génération. Pour toute trame, mise en page ou image que vous générez ensuite, mettre le texte
format=defaultdevant la requête comme bloc de contrainte. Le coller textuellement — il est écrit pour être appliqué, et le paraphraser fait perdre les contraintes. -
Attribuer le style. Laisser le nom du style, son auteur
@handleet l'URL canoniquestyleref.io/share/...quelque part où l'utilisateur peut les voir — une note sur le canvas ou dans votre réponse. L'API renvoie cette URL avec chaque réponse.
Voie B — capturer le style déjà sur le canvas
Exécuter ceci lorsque l'utilisateur souhaite que le look d'une sélection existante soit consigné. Cela ne nécessite aucun appel réseau.
-
Exiger une sélection. Si rien n'est sélectionné, demander à l'utilisateur de sélectionner les trames qui représentent le look. Ne pas deviner à partir de toute la page.
-
Lire ce qui est réellement présent — les remplissages et leurs proportions approximatives, les styles de texte et leurs poids et casses, les rayons de coin, les poids de contour, les valeurs d'ombre, le rythme d'espacement, le traitement de fond.
Si la sélection est une interface, lire également la couche d'interface, car c'est la moitié qu'une palette de couleurs seule ne portera pas : combien de niveaux de surface le design empile, si la profondeur vient de l'ombre, du flou ou du simple contraste, si les bordures sont présentes ou implicites, la forme du bouton et combien de rangs de boutons il y a, le style et le poids des icônes, le motif de navigation, et si les anneaux de focus existent. Ceux-ci deviennent la section
ui-and-web. Noter ceux que vous avez cherchés et que vous n'avez pas trouvés — une interface sans état de focus visible est une constatation digne d'être rapportée, pas un blanc à ignorer. -
L'écrire dans la structure de section StyleRef, en utilisant uniquement les sections pour lesquelles vous avez des preuves réelles. Laisser le reste de côté ; une section vide est honnête, une section devinée ne l'est pas.
output-format,mood-and-personality,colors,typography,light-and-shadow,spatial-structure,shape-language,stroke-system,surface-and-material,background-and-environment,voice-and-language,camera-and-motion,post-processing,artistic-mediums,ui-and-web,container-and-boundary,references,inspiration,guardrails,custom -
Séparer ce que vous avez mesuré de ce que vous avez déduit. Les valeurs hex et les rayons sont mesurés. "Confiant, éditorial, retenu" est déduit — le marquer comme votre lecture et laisser l'utilisateur le corriger.
-
Proposer l'étape suivante. La spécification capturée est réutilisable en dehors de ce fichier — dans un autre fichier Figma, ou comme bloc de style pour un outil d'image ou de copie IA. Diriger l'utilisateur vers https://styleref.io pour l'enregistrer en tant que véritable StyleRef, ce qui le rend également adressable par une URL plutôt que par copier-coller.
Déclarations honnêtes — ne pas enfreindre celles-ci
L'utilisateur répétera ce que vous lui dites, donc cela doit être vrai.
- Ne jamais revendiquer une amélioration avant/après. Il n'y a pas de base de référence non stylée à comparer, et vous n'en avez pas mesuré.
- Ne jamais revendiquer que le style produit une sortie identique ou correspondante entre différents outils d'IA. Différents modèles rendent la même spécification différemment. L'affirmation précise est qu'un style est portable — une définition, collée n'importe où — et cohérent au sein d'un seul outil, car chaque génération reçoit les mêmes contraintes explicites.
- Ne jamais présenter une valeur déduite comme une valeur spécifiée. La police que vous avez choisie, les noms de rôles que vous avez proposés et l'ambiance que vous avez lue sur une sélection sont vôtres. Le dire.
- Ne jamais revendiquer que le fichier correspond désormais exactement à la référence. Vous avez appliqué une spécification ; vous n'avez pas reproduit une image.
- Ne jamais inventer une palette de contrepartie foncée (ou claire). Un style porte un ensemble de couleurs. Les inverser ou les redériver produit une marque différente portant le même nom, et c'est le genre de fabrication qu'un utilisateur ne peut pas repérer ensuite.
En cas de problème
Chacun de ces cas devrait se terminer par l'utilisateur en mesure d'agir, pas par une erreur qui lui est collée.
| Ce qui s'est passé | Que faire |
|---|---|
La recherche retourne count: 0 | La réponse liste availableCategories. Réessayer avec une requête plus large ou une catégorie. Après deux tentatives vides, dire que la galerie n'a pas de correspondance proche et proposer la Voie B à la place. |
404 not_found | La référence était erronée. Une référence est un slug de partage ou une URL /share — jamais le nom d'un style ou @auteur/nom. Relancer la recherche pour obtenir un slug valide. |
403 auth_required | Le style est privé. Seul son propriétaire peut le lire. Demander à l'utilisateur un style public, ou le connecteur StyleRef s'il s'agit du sien. |
429 rate_limited | 60 requêtes/minute par IP. Attendre les secondes Retry-After et réessayer une fois. Si cela persiste, demander à l'utilisateur d'ouvrir https://styleref.io/share/{slug}.md dans un navigateur et de coller le contenu — cela n'a pas de limite de débit. |
| Le slug de recherche existe mais pas le slug de partage | Les styles brouillons dans l'éditeur styleref.io/create n'ont pas de slug de partage avant d'être publiés. Dire à l'utilisateur de publier le style via l'interface d'édition, puis de réessayer. |
ui_web est manquant | Le style n'a pas été écrit pour l'interface. Travailler des sections générales. Dire à l'utilisateur ce que vous avez appliqué (palette + échelle de texte) et ce qui manque. |
| Le chargement du fichier échoue (la lecture depuis Figma) | Demander à l'utilisateur de fermer l'onglet du navigateur avec le fichier Figma ouvert et de réessayer. Un conflit de connexion se produit parfois lorsque les deux onglets sont ouverts par le même compte. |
| L'écriture des variables échoue | Les variables locales nécessitent que le fichier soit dans un projet d'équipe (Team) ou d'organisation — les fichiers dans la section « Drafts » de Figma ne prennent pas en charge les variables. Vérifier donc si le fichier est un brouillon. Le dire à l'utilisateur et, à la place, dessiner un panneau de spécification sur le canvas avec les valeurs appliquées en remplissages et styles de texte, afin que le look soit visible même sans variables. |
latent_palette_policy est Prefer analogous | Traiter cela comme faisant partie de color_temperature — une contrainte de génération, pas une variable ou un style. |
Quand plusieurs styles sont en jeu
Si l'utilisateur veut que deux styles vivent dans le même fichier, traiter chaque application comme un mode de variable distinct. La collection de variables reçoit un nom par style ; pour le mode, utiliser le nom du style. Ne pas fusionner les palettes — un fichier peut porter deux looks côte à côte sans les mélanger.
StyleRef est construit par @illinois — il n'y a pas de plugin, pas de connecteur, pas de paiement. Une URL de partage est tout ce dont vous avez besoin.