# [UI UX Pro Max](https://uupm.cc)

🇩🇿 Azərbaycanca | đŸ‡źđŸ‡© Bahasa Indonesia | đŸ‡ŻđŸ‡” æ—„æœŹèȘž | đŸ‡°đŸ‡· 한ꔭ얎 | đŸ‡»đŸ‡ł Tiáșżng Việt | 🇹🇳 çź€äœ“äž­æ–‡ | đŸ‡ș🇾 English | đŸ‡«đŸ‡· Français | đŸ‡źđŸ‡· ÙŰ§Ű±ŰłÛŒ |

Version GitHub 194 rĂšgles de raisonnement 80 styles d'interface consultables Python 3.x Licence

npm tĂ©lĂ©chargements npm Étoiles GitHub PayPal

Un skill d'IA qui apporte une intelligence de design pour créer des interfaces UI/UX professionnelles sur de multiples plateformes et frameworks.

UI UX Pro Max

Si ce projet vous est utile, pensez Ă  le soutenir :

Faire un don via PayPal

Autres projets
NextLevelBuilder.io | GoClaw.sh | AgentKit.best | TOSE.sh

---

Découvrez notre nouveau skill :
3Dviz Pro Max

Transformez une idĂ©e en une scĂšne 3D qui mĂ©rite d'ĂȘtre explorĂ©e.

Harness Village : un village fantastique avec navigation de caméra et créatures animées

Source d'inspiration visuelle, pas un benchmark. Projet fourni par l'auteur et enregistrĂ© avant l'existence de ce skill ; son interface contient du vietnamien. Il s'agit d'images d'archives, et non d'une dĂ©mo en anglais ni d'un test d'exĂ©cution du skill — voir la provenance des mĂ©dias.

đŸ€Œ Site web : https://3dviz.dev/

--- ## NouveautĂ©s de la v2.0 ### GĂ©nĂ©ration intelligente de design system La fonctionnalitĂ© phare de la v2.0 est le **GĂ©nĂ©rateur de design system** : un moteur de raisonnement propulsĂ© par l'IA qui analyse les besoins de votre projet et gĂ©nĂšre en quelques secondes un design system complet et sur mesure. ``` +----------------------------------------------------------------------------------------+ | CIBLE : Serenity Spa - DESIGN SYSTEM RECOMMANDÉ | +----------------------------------------------------------------------------------------+ | | | PATTERN : Hero centrĂ© + preuve sociale | | Conversion : axĂ©e sur l'Ă©motion, avec Ă©lĂ©ments de confiance | | CTA : au-dessus de la ligne de flottaison, rĂ©pĂ©tĂ© aprĂšs les tĂ©moignages | | Sections : | | 1. Hero | | 2. Services | | 3. TĂ©moignages | | 4. RĂ©servation | | 5. Contact | | | | STYLE : Soft UI Evolution | | Mots-clĂ©s : ombres douces, profondeur subtile, apaisant, premium, formes organiques| | IdĂ©al pour : bien-ĂȘtre, beautĂ©, marques lifestyle, services premium | | Performance : cost:low | AccessibilitĂ© : risk:conditional ; vĂ©rifier les exigences | | | | COULEURS : | | Primaire : #E8B4B8 (rose doux) | | Secondaire : #A8D5BA (vert sauge) | | CTA : #D4AF37 (or) | | ArriĂšre-plan : #FFF5F5 (blanc chaud) | | Texte : #2D3436 (anthracite) | | Notes : palette apaisante avec touches dorĂ©es pour un rendu luxueux | | | | TYPOGRAPHIE : Cormorant Garamond / Montserrat | | Ambiance : Ă©lĂ©gante, apaisante, sophistiquĂ©e | | IdĂ©al pour : marques de luxe, bien-ĂȘtre, beautĂ©, Ă©ditorial | | Google Fonts : https://fonts.google.com/share?selection.family=... | | | | EFFETS CLÉS : | | Ombres douces + transitions adaptĂ©es au contexte + survols dĂ©licats | | | | À ÉVITER (anti-patterns) : | | NĂ©ons vifs + animations brusques + mode sombre + dĂ©gradĂ©s IA violet/rose | | | | CHECK-LIST AVANT LIVRAISON : | | [ ] Pas d'emojis comme icĂŽnes (utiliser des SVG : Heroicons/Lucide) | | [ ] cursor-pointer sur tous les Ă©lĂ©ments cliquables | | [ ] Timing des interactions selon plateforme, composant et prĂ©fĂ©rences utilisateur | | [ ] Mode clair : contraste du texte d'au moins 4.5:1 | | [ ] États de focus visibles pour la navigation au clavier | | [ ] prefers-reduced-motion respectĂ© | | [ ] Textes, chips et badges se rĂ©organisent sans troncature ni libellĂ© cassĂ© | | [ ] Responsive : 375px, 768px, 1024px, 1440px | | | +----------------------------------------------------------------------------------------+ ``` ### Comment fonctionne la gĂ©nĂ©ration de design system ``` ┌─────────────────────────────────────────────────────────────────┐ │ 1. DEMANDE DE L'UTILISATEUR │ │ « CrĂ©e une landing page pour mon spa de beautĂ© » │ └─────────────────────────────────────────────────────────────────┘ │ â–Œ ┌─────────────────────────────────────────────────────────────────┐ │ 2. RECHERCHE MULTI-DOMAINES (5 recherches en parallĂšle) │ │ ‱ Correspondance du type de produit (194 catĂ©gories) │ │ ‱ Recommandations de style (80 consultables ; 51 actifs) │ │ ‱ SĂ©lection de palette de couleurs (194 palettes) │ │ ‱ Patterns de landing page (34 patterns) │ │ ‱ Associations typographiques (74 combinaisons de polices) │ └─────────────────────────────────────────────────────────────────┘ │ â–Œ ┌─────────────────────────────────────────────────────────────────┐ │ 3. MOTEUR DE RAISONNEMENT │ │ ‱ Associer produit → rĂšgles de catĂ©gorie UI │ │ ‱ Appliquer les prioritĂ©s de style (classement BM25) │ │ ‱ Filtrer les anti-patterns propres au secteur │ │ ‱ Traiter les rĂšgles de dĂ©cision (conditions JSON) │ └─────────────────────────────────────────────────────────────────┘ │ â–Œ ┌─────────────────────────────────────────────────────────────────┐ │ 4. DESIGN SYSTEM COMPLET EN SORTIE │ │ Pattern + Style + Couleurs + Typographie + Effets │ │ + Anti-patterns Ă  Ă©viter + Check-list avant livraison │ └─────────────────────────────────────────────────────────────────┘ ``` ### 194 rĂšgles de raisonnement spĂ©cifiques Ă  chaque secteur Le moteur de raisonnement comprend des rĂšgles spĂ©cialisĂ©es pour : | CatĂ©gorie | Exemples | |----------|----------| | **Tech & SaaS** | SaaS, Micro SaaS, service B2B, outil de dĂ©veloppement / IDE, plateforme IA/chatbot, plateforme de cybersĂ©curitĂ© | | **Finance** | Fintech/crypto, banque, assurance, suivi des finances personnelles, outil de factures et de facturation | | **SantĂ©** | Clinique mĂ©dicale, pharmacie, dentaire, vĂ©tĂ©rinaire, santĂ© mentale, rappel de mĂ©dicaments | | **E-commerce** | GĂ©nĂ©raliste, luxe, marketplace (P2P), box par abonnement, livraison de repas | | **Services** | BeautĂ©/spa, restaurant, hĂŽtel, juridique, services Ă  domicile, rĂ©servation et prise de rendez-vous | | **CrĂ©atif** | Portfolio, agence, photographie, jeux vidĂ©o, streaming musical, Ă©diteur photo/vidĂ©o | | **Lifestyle** | Suivi d'habitudes, recettes et cuisine, mĂ©ditation, mĂ©tĂ©o, journal intime, suivi de l'humeur | | **Technologies Ă©mergentes** | Web3/NFT, informatique spatiale, informatique quantique, flotte de drones autonomes | Chaque rĂšgle comprend : - **Pattern recommandĂ©** - Structure de la landing page - **PrioritĂ© de style** - Styles d'interface les plus adaptĂ©s - **Ambiance colorimĂ©trique** - Palettes adaptĂ©es au secteur - **Ambiance typographique** - PersonnalitĂ© des polices - **Effets clĂ©s** - Animations et interactions - **Anti-patterns** - Ce qu'il ne faut PAS faire (p. ex. « dĂ©gradĂ©s IA violet/rose » pour une banque) ## FonctionnalitĂ©s - **80 styles d'interface consultables (51 actifs)** - Glassmorphism, Claymorphism, Minimalisme, Brutalisme, Neumorphism, Bento Grid, mode sombre, AI-Native UI, et bien d'autres - **194 palettes de couleurs** - Palettes sectorielles alignĂ©es 1:1 sur les 194 types de produits - **74 associations de polices** - Combinaisons typographiques sĂ©lectionnĂ©es, avec imports Google Fonts - **25 types de graphiques** - Recommandations pour tableaux de bord et analytique - **22 stacks techniques** - React, Next.js, Astro, Vue, Nuxt.js, Nuxt UI, Svelte, SwiftUI, React Native, Flutter, HTML+Tailwind, shadcn/ui, Jetpack Compose, Angular, Laravel, Three.js, JavaFX, WPF, WinUI 3, UWP, Avalonia, Uno Platform - **130 recommandations UX** - Bonnes pratiques, anti-patterns, rĂšgles d'accessibilitĂ©, mise en page de texte robuste, libellĂ©s compacts et interactions annulables. Voir [Raccourcis EntrĂ©e compatibles IME](docs/ime-composition.md). - **194 rĂšgles de raisonnement** - GĂ©nĂ©ration de design system spĂ©cifique Ă  chaque secteur (NOUVEAU en v2.0) ### Texte robuste et interface compacte Les recommandations couvrent dĂ©sormais les dĂ©faillances courantes en production concernant les titres, les chaĂźnes longues, les chips, les badges et les micro-interactions interrompues : - L'Ă©quilibrage du retour Ă  la ligne des titres est une amĂ©lioration progressive, et non une garantie qu'un mot prĂ©cis restera sur la derniĂšre ligne. Les designs doivent fonctionner avec un retour Ă  la ligne naturel, quels que soient la largeur, la police et la langue. - Le texte essentiel doit se rĂ©organiser sans ĂȘtre tronquĂ© sur les Ă©crans Ă©troits, avec le zoom du navigateur, l'agrandissement du texte et les espacements personnalisĂ©s par l'utilisateur. Les URL et identifiants longs peuvent passer Ă  la ligne en toute sĂ©curitĂ©. - Les collections de chips et de tags doivent passer Ă  la ligne ou utiliser un bouton `+n` fonctionnel pour afficher le reste. Un libellĂ© compact doit rester entier lorsque c'est possible ; une troncature inĂ©vitable nĂ©cessite un moyen accessible d'afficher la valeur complĂšte, au clavier, Ă  la souris et au toucher. - Le sens d'un badge ne peut pas reposer uniquement sur la couleur. Les chips interactives nĂ©cessitent une sĂ©mantique native, un focus visible et un Ă©tat exposĂ© programmatiquement ; les compteurs dynamiques ont besoin d'un contexte explicite. - Des interactions rapides peuvent interrompre une animation, mais l'Ă©tat sĂ©mantique final, le focus et le contenu doivent rester corrects. Le timing est choisi selon la plateforme et le composant, en respectant les prĂ©fĂ©rences de rĂ©duction des animations. ### Taxonomie des styles Le catalogue contient **80 styles consultables**, reposant sur des identifiants stables et des alias : | Statut | Nombre | Comportement de recherche | |--------|------:|-----------------| | Actif | 51 | Inclus dans les recommandations normales et affichĂ© par dĂ©faut dans la galerie | | ComplĂ©mentaire | 29 | RenvoyĂ© en cas de demande exacte ou explicite de variante/systĂšme ; disponible via le filtre de statut de la galerie | | ObsolĂšte | 9 | Exclu du classement normal ; les anciens noms redirigent vers un style canonique ou un pattern de landing page | L'ensemble actif couvre 43 familles visuelles gĂ©nĂ©rales, 2 styles propres au mobile, 4 systĂšmes de design officiels de plateformes, 1 matĂ©riau de plateforme et 1 style analytique de base. Les systĂšmes officiels actuels comprennent Fluent 2, Shopify Polaris, Adobe Spectrum et Apple Native Experience ; Liquid Glass est dĂ©fini comme un matĂ©riau de la plateforme Apple, Material 3 Expressive reste une variante mobile de Material, et Spectrum 2 est complĂ©mentaire. Les structures de landing page sont regroupĂ©es dans un jeu de donnĂ©es distinct de 34 patterns, plutĂŽt que d'entrer en concurrence avec les styles visuels dans le classement BM25. Voir [`styles.csv`](src/ui-ux-pro-max/data/styles.csv) pour la taxonomie complĂšte et les mĂ©tadonnĂ©es de provenance. ## 💎 Comparaison des versions Basic et Premium De nombreux utilisateurs nous interrogent sur les diffĂ©rences entre la version open source et la version premium. Voici un comparatif dĂ©taillĂ© pour vous aider Ă  choisir celle qui correspond Ă  votre façon de travailler. ### 🟱 Version Basic (ce dĂ©pĂŽt) * **EntiĂšrement open source :** IdĂ©ale pour les dĂ©veloppeurs indĂ©pendants, les amateurs et les projets classiques. * **Intelligence UI/UX de base :** AccĂšs complet aux 80 styles d'interface consultables (51 actifs), aux 194 types de produits, aux palettes de couleurs et aux associations de polices sĂ©lectionnĂ©es. * **Recommandations intelligentes :** Moteur de recherche BM25 intĂ©grĂ© pour des correspondances de design trĂšs prĂ©cises. * **Prise en charge multiplateforme :** Recommandations spĂ©cifiques Ă  22 frameworks majeurs (React, Vue, Tailwind, iOS, Android, etc.). * **GĂ©nĂ©ration de design system :** GĂ©nĂ©rez instantanĂ©ment des rĂšgles d'interface, des patterns et une logique sur mesure via la CLI. ### 🟡 Version Premium * **CompĂ©tences Ă©tendues en design de marque :** Va au-delĂ  de l'UI/UX avec la gĂ©nĂ©ration d'identitĂ© de marque, la crĂ©ation de logos, les programmes d'identitĂ© visuelle (CIP), les banniĂšres, les diapositives de prĂ©sentation et des icĂŽnes sur mesure. * **CrĂ©ation avancĂ©e de ressources :** IntĂ©gration poussĂ©e avec la gĂ©nĂ©ration d'images par IA pour crĂ©er de vĂ©ritables ressources visuelles, et pas seulement des placeholders. * **Architecture entreprise :** Une architecture de design tokens plus complĂšte et Ă©volutive, conçue pour les dĂ©ploiements dans de grandes Ă©quipes. * **Support prioritaire :** Assistance technique dĂ©diĂ©e pour les Ă©quipes et les professionnels qui ont besoin d'un workflow de design complet et ininterrompu. 👉 *Pour en savoir plus sur le passage Ă  la version Premium, rendez-vous sur [uupm.cc](https://uupm.cc).* ## Installation ### Via la Claude Marketplace (Claude Code) Installez-le directement dans Claude Code en deux commandes : ``` /plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill /plugin install ui-ux-pro-max@ui-ux-pro-max-skill ``` ### Via la CLI (recommandĂ©) ```bash # Installer la CLI globalement npm install -g ui-ux-pro-max-cli # Aller dans votre projet cd /path/to/your/project # Installer pour votre assistant IA uipro init --ai claude # Claude Code uipro init --ai cursor # Cursor uipro init --ai windsurf # Windsurf uipro init --ai antigravity # Antigravity uipro init --ai copilot # GitHub Copilot uipro init --ai kiro # Kiro uipro init --ai codex # Codex CLI uipro init --ai qoder # Qoder uipro init --ai roocode # Roo Code uipro init --ai gemini # Gemini CLI uipro init --ai trae # Trae uipro init --ai opencode # OpenCode uipro init --ai continue # Continue uipro init --ai codebuddy # CodeBuddy uipro init --ai droid # Droid (Factory) uipro init --ai kilocode # KiloCode uipro init --ai warp # Warp uipro init --ai augment # Augment uipro init --ai codewhale # CodeWhale uipro init --ai zcode # ZCode uipro init --ai kimi # Kimi Code uipro init --ai amazonq # Amazon Q Developer uipro init --ai openclaw # OpenClaw (.agents/skills/) uipro init --ai autoclaw # AutoClaw (skills/ ou ~/.openclaw-autoclaw/skills) uipro init --ai universal # Universel / Agent Standard (.agents/skills/) uipro init --ai all # Tous les assistants ``` Le paquet npm s'appelle `ui-ux-pro-max-cli` ; il installe toujours la commande `uipro`. Les anciennes versions de `uipro-cli` sont obsolĂštes et ne doivent pas ĂȘtre utilisĂ©es pour les ressources actuelles. ### Installation globale (disponible pour tous les projets) ```bash uipro init --ai claude --global # Installe dans ~/.claude/skills/ uipro init --ai cursor --global # Installe dans ~/.cursor/skills/ uipro init --ai zcode --global # Installe dans ~/.zcode/skills/ uipro init --ai kimi --global # Installe dans ~/.kimi-code/skills/ uipro init --ai universal --global # Installe dans ~/.agents/skills/ ``` ### Autres commandes de la CLI ```bash uipro versions # Lister les versions disponibles uipro update # Actualiser les fichiers du skill depuis le paquet CLI installĂ© uipro update --global # Actualiser les fichiers globaux du skill depuis le paquet CLI installĂ© uipro init --offline # Option de compatibilitĂ© ; installe les templates intĂ©grĂ©s uipro init --dry-run # PrĂ©visualiser l'installation sans Ă©crire de fichiers uipro uninstall # Supprimer le skill (dĂ©tection automatique de la plateforme) uipro uninstall --ai claude # Supprimer pour une plateforme prĂ©cise uipro uninstall --global # Supprimer l'installation globale ``` ## PrĂ©requis Python 3.x est requis pour le script de recherche (bibliothĂšque standard uniquement : les scripts n'installent rien et n'effectuent aucun appel rĂ©seau). VĂ©rifiez si Python est installĂ© : ```bash python3 --version ``` S'il est absent, installez-le vous-mĂȘme depuis [python.org](https://www.python.org/downloads/) ou avec le gestionnaire de paquets de votre systĂšme (Homebrew, apt, winget). Ces Ă©tapes d'installation s'adressent Ă  **vous, l'utilisateur humain** : les agents IA qui utilisent ce skill ne doivent jamais installer de logiciel sur votre machine ; ils ont pour consigne de vous le demander. ## Utilisation ### Mode Skill (activation automatique) **Pris en charge :** Claude Code, Cursor, Windsurf, Antigravity, Codex CLI, Continue, Gemini CLI, OpenCode, Qoder, CodeBuddy, Droid (Factory), KiloCode, Warp, Augment, CodeWhale, ZCode, Kimi Code, Amazon Q Developer, OpenClaw, GitHub Copilot Le skill s'active automatiquement lorsque vous demandez un travail d'UI/UX. Discutez simplement de façon naturelle : ``` CrĂ©e une landing page pour mon produit SaaS ``` > **Trae** : passez d'abord en mode **SOLO**. Le skill s'activera pour les demandes d'UI/UX. ### Mode Workflow (commande slash) **Pris en charge :** Kiro, Roo Code, KiloCode Utilisez la commande slash pour invoquer le skill : ``` /ui-ux-pro-max CrĂ©e une landing page pour mon produit SaaS ``` ### Exemples de prompts ``` CrĂ©e une landing page pour mon produit SaaS CrĂ©e un tableau de bord d'analytique pour le secteur de la santĂ© Conçois un site portfolio avec mode sombre RĂ©alise l'interface d'une application mobile d'e-commerce CrĂ©e une application bancaire fintech avec un thĂšme sombre ``` ### Appliquer un thĂšme Ă  une application existante AprĂšs avoir [installĂ© le skill](#installation), ouvrez votre application dans votre assistant IA et utilisez un prompt comme celui-ci. En mode Workflow, prĂ©fixez-le avec `/ui-ux-pro-max`. ```text Utilise le skill ui-ux-pro-max pour changer le thĂšme de mon application React existante. Style cible : Minimalism & Swiss Style. Commence par examiner les versions du framework et de la bibliothĂšque de styles, les routes, les composants, les styles et les tokens de thĂšme existants. Conserve la structure actuelle des composants, leur comportement et la logique mĂ©tier. RĂ©utilise et mets Ă  jour les tokens sĂ©mantiques existants pour les couleurs, la typographie, les espacements, les rayons, les ombres et les Ă©tats d'interaction ; ajoute les tokens manquants plutĂŽt que de crĂ©er un systĂšme de thĂšme parallĂšle. Remplace les styles codĂ©s en dur un composant Ă  la fois. VĂ©rifie le contraste, le focus clavier, les mises en page responsive et tous les modes clair/sombre pris en charge. RĂ©sume les fichiers modifiĂ©s et les styles codĂ©s en dur restants. ``` Remplacez `Minimalism & Swiss Style` par le [style du catalogue](src/ui-ux-pro-max/data/styles.csv) ou la direction visuelle de votre choix. Les rĂ©sultats de recherche fournissent des recommandations de design ; ils ne réécrivent pas automatiquement votre application. **Check-list de migration de thĂšme :** - **Auditer :** repĂ©rez les valeurs codĂ©es en dur liĂ©es au thĂšme dans les feuilles de style, les styles inline et les classes utilitaires comme `bg-blue-600` ou `text-[#1e293b]`. - **Associer :** rĂ©utilisez des rĂŽles sĂ©mantiques tels que `background`, `surface`, `foreground`, `primary`, `border` et `ring` dans le systĂšme de styles existant de l'application. Ajoutez les rĂŽles manquants en suivant les conventions de la version installĂ©e de sa bibliothĂšque. - **Migrer :** remplacez les valeurs codĂ©es en dur par des rĂ©fĂ©rences aux tokens, par petits lots de composants. Modifier uniquement les tokens n'aura aucun effet sur les styles qui ne les utilisent pas. - **VĂ©rifier :** contrĂŽlez le contraste du texte et de l'interface, les Ă©tats de survol/focus/dĂ©sactivĂ©, les mises en page responsive et chaque thĂšme pris en charge aprĂšs chaque lot. ### Comment ça marche 1. **Vous demandez** - Formulez n'importe quelle tĂąche d'UI/UX (crĂ©er, concevoir, implĂ©menter, relire, corriger, amĂ©liorer) 2. **GĂ©nĂ©ration du design system** - L'IA gĂ©nĂšre automatiquement un design system complet grĂące au moteur de raisonnement 3. **Recommandations intelligentes** - En fonction de votre type de produit et de vos besoins, il trouve les styles, couleurs et typographies les plus adaptĂ©s 4. **GĂ©nĂ©ration du code** - ImplĂ©mente l'interface avec les bonnes couleurs, polices, espacements et bonnes pratiques 5. **VĂ©rifications avant livraison** - ContrĂŽle le rĂ©sultat par rapport aux anti-patterns UI/UX courants ### Stacks prises en charge Le skill fournit des recommandations spĂ©cifiques pour : | CatĂ©gorie | Stacks | |----------|--------| | **Web (HTML)** | HTML + Tailwind (par dĂ©faut) | | **ÉcosystĂšme React** | React, Next.js, shadcn/ui | | **ÉcosystĂšme Vue** | Vue, Nuxt.js, Nuxt UI | | **Angular** | Angular | | **PHP** | Laravel (Blade, Livewire, Inertia.js) | | **Autre (Web)** | Svelte, Astro, Three.js | | **Desktop** | JavaFX, WPF, WinUI 3, Avalonia, Uno Platform, UWP | | **iOS** | SwiftUI | | **Android** | Jetpack Compose | | **Multiplateforme** | React Native, Flutter | Il suffit de mentionner la stack de votre choix dans le prompt, ou de laisser la valeur par dĂ©faut, HTML + Tailwind. ## Exemples ### Avant/aprĂšs : tableau de bord d'exploitation Un tableau de bord d'exploitation sobre ([avant](https://skill-fixture-before.theroost.dev)) restylĂ© uniquement Ă  partir du design system gĂ©nĂ©rĂ© pour lui par UI UX Pro Max ([aprĂšs](https://ui-ux-pro-max-after.theroost.dev)), via `search.py "internal operations dashboard" --design-system --density 8 --motion 3 --variance 4`. *Exemple illustratif proposĂ© par la communautĂ© ; il ne s'agit ni d'une dĂ©mo officielle, ni d'un benchmark, ni d'un test d'exĂ©cution du skill.* ## Commande Design System (avancĂ©) Pour accĂ©der directement au gĂ©nĂ©rateur de design system : > Remarque : si vous avez installĂ© le skill via Continue, remplacez `.claude/skills/` par `.continue/skills/` dans les commandes ci-dessous. Pour Droid (Factory), utilisez `.factory/skills/`. Pour ZCode, utilisez `.zcode/skills/`. Pour Amazon Q Developer, utilisez `.amazonq/skills/` (Amazon Q ne charge automatiquement que la rĂšgle situĂ©e dans `.amazonq/rules/ui-ux-pro-max.md` ; les donnĂ©es et scripts de `.amazonq/skills/` sont des fichiers rĂ©fĂ©rencĂ©s par cette rĂšgle). ```bash # GĂ©nĂ©rer un design system avec une sortie ASCII python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness" --design-system -p "Serenity Spa" # GĂ©nĂ©rer avec une sortie Markdown python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech banking" --design-system -f markdown # Recherche par domaine python3 .claude/skills/ui-ux-pro-max/scripts/search.py "glassmorphism" --domain style python3 .claude/skills/ui-ux-pro-max/scripts/search.py "elegant serif" --domain typography python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain chart python3 .claude/skills/ui-ux-pro-max/scripts/search.py "error summary validation" --domain ux python3 .claude/skills/ui-ux-pro-max/scripts/search.py "decorative icon aria hidden" --domain icons python3 .claude/skills/ui-ux-pro-max/scripts/search.py "icon button accessible label" --domain icons python3 .claude/skills/ui-ux-pro-max/scripts/search.py "orphan heading line balance" --domain ux python3 .claude/skills/ui-ux-pro-max/scripts/search.py "badge chip label wraps to second line" --domain ux python3 .claude/skills/ui-ux-pro-max/scripts/search.py "rapid chip animation interrupted" --domain ux # Interfaces RTL / arabe, hĂ©breu, persan (domaines style et product) python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain style --rtl=full python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech" --domain product --rtl=partial # Recommandations spĂ©cifiques Ă  une stack python3 .claude/skills/ui-ux-pro-max/scripts/search.py "form validation" --stack react python3 .claude/skills/ui-ux-pro-max/scripts/search.py "responsive layout" --stack html-tailwind python3 .claude/skills/ui-ux-pro-max/scripts/search.py "chip badge overflow nowrap" --stack html-tailwind python3 .claude/skills/ui-ux-pro-max/scripts/search.py "tableview binding" --stack javafx python3 .claude/skills/ui-ux-pro-max/scripts/search.py "atlantafx primer enterprise theme" --stack javafx python3 .claude/skills/ui-ux-pro-max/scripts/search.py "enterprise tableview density permission" --stack javafx ``` La recherche pour les stacks web tient compte des versions. Les requĂȘtes sans mention d'une version majeure antĂ©rieure renvoient les recommandations actuelles et actives. Les termes explicitement anciens ou les versions majeures antĂ©rieures (par exemple `Svelte 4` ou `Next.js 15`) ne renvoient que des lignes historiques sĂ©lectionnĂ©es, Ă©tiquetĂ©es par `Status` et `Applies To` ; lorsqu'aucune recommandation historique correspondante n'existe, la recherche ne renvoie aucun rĂ©sultat plutĂŽt que de mĂ©langer les gĂ©nĂ©rations de frameworks. ### CompatibilitĂ© RTL (`--rtl`) Chaque ligne de style et de produit comporte un `rtl_level` pour les interfaces de droite Ă  gauche (arabe, hĂ©breu, persan, ourdou) : | Niveau | Signification | |-------|---------| | `full` | IndĂ©pendant du sens de lecture : la mise en page supporte l'inversion sans modification. | | `partial` | S'inverse proprement, mais certains composants et animations doivent ĂȘtre ajustĂ©s. | | `caveats` | Le style ou le produit encode le sens de lecture (typographie cinĂ©tique, frises chronologiques LTR, surfaces de code/terminal, cartes et ordre des siĂšges). | ```bash # Uniquement les styles qui s'inversent sans travail supplĂ©mentaire python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain style --rtl=full # Tous les niveaux, rĂ©sultats filtrĂ©s toujours Ă©tiquetĂ©s avec rtl_level python3 .claude/skills/ui-ux-pro-max/scripts/search.py "mobile" --domain style --rtl ``` `--rtl` nĂ©cessite un `--domain style` ou `--domain product` explicite. Le filtre est appliquĂ© aprĂšs le classement mais avant la troncature `-n/--max-results`, de sorte qu'une limite Ă©troite ne masque jamais une ligne correspondante. Il est refusĂ© avec `--design-system` et `--stack`. ### Persister le design system (pattern Master + Overrides) Enregistrez votre design system dans des fichiers pour une **rĂ©cupĂ©ration hiĂ©rarchique d'une session Ă  l'autre** : ```bash # GĂ©nĂ©rer et enregistrer dans design-system/myapp/MASTER.md python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist -p "MyApp" # CrĂ©er Ă©galement un fichier de surcharge propre Ă  une page python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist -p "MyApp" --page "dashboard" ``` Cela crĂ©e une arborescence `design-system/` : ``` design-system/ └── myapp/ # Un dossier par projet (slug de -p "MyApp") ├── MASTER.md # Source de vĂ©ritĂ© globale (couleurs, typographie, espacements, composants) └── pages/ └── dashboard.md # Surcharges propres Ă  la page (uniquement les Ă©carts par rapport au Master) ``` **Fonctionnement de la rĂ©cupĂ©ration hiĂ©rarchique :** 1. Lorsque vous crĂ©ez une page prĂ©cise (p. ex. « Checkout »), vĂ©rifiez d'abord `design-system/[project-slug]/pages/checkout.md` 2. Si le fichier de la page existe, ses rĂšgles **remplacent** celles du fichier Master 3. Sinon, utilisez exclusivement `design-system/[project-slug]/MASTER.md` **Prompt de rĂ©cupĂ©ration contextuelle :** ``` Je crĂ©e la page [Nom de la page]. Lis design-system/[project-slug]/MASTER.md. VĂ©rifie aussi si design-system/[project-slug]/pages/[page-name].md existe. Si le fichier de la page existe, donne la prioritĂ© Ă  ses rĂšgles. Sinon, utilise exclusivement les rĂšgles du Master. Maintenant, gĂ©nĂšre le code... ``` ## Architecture et contribution ### Pour les utilisateurs Le code a Ă©tĂ© restructurĂ© autour d'un **systĂšme de gĂ©nĂ©ration Ă  base de templates**. Tous les fichiers propres Ă  chaque plateforme (`.cursor/`, `.windsurf/`, `.kiro/`, `.factory/`, etc.) sont dĂ©sormais gĂ©nĂ©rĂ©s dynamiquement par la CLI. **Utilisez toujours la CLI pour installer :** ```bash npm install -g ui-ux-pro-max-cli uipro init --ai ``` Vous obtenez ainsi les derniers templates fournis avec le paquet CLI installĂ©, ainsi que la structure de fichiers adaptĂ©e Ă  votre assistant IA. Mettez d'abord Ă  jour le paquet npm lorsqu'une nouvelle version est publiĂ©e. ### Pour les contributeurs Si vous souhaitez contribuer Ă  ce projet : ```bash # 1. Cloner le dĂ©pĂŽt git clone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git cd ui-ux-pro-max-skill # 2. Comprendre la structure src/ui-ux-pro-max/ # Source de vĂ©ritĂ© (donnĂ©es, scripts, templates) cli/ # Installeur CLI (gĂ©nĂšre les fichiers Ă  partir des templates) .claude/ # DĂ©veloppement/test local du skill Claude Code .factory/ # DĂ©veloppement/test local du skill Droid (Factory) # 3. Apporter vos modifications dans src/ui-ux-pro-max/ # - data/*.csv → Fichiers de base de donnĂ©es # - scripts/*.py → Moteur de recherche et design system # - templates/ → Templates propres Ă  chaque plateforme # 4. Synchroniser vers la CLI et tester en local cd cli npm run sync:assets npm run check:assets npm run verify:data npm run typecheck # 5. Compiler et tester la CLI # `npm run build` utilise Bun s'il est disponible, sinon le compilateur TypeScript aprĂšs `npm ci`. npm run build node dist/index.js init --ai claude --offline # Tester dans un dossier temporaire node dist/index.js init --ai claude --dry-run # PrĂ©visualiser l'installation (aucune Ă©criture) # 6. CrĂ©er une PR (ne jamais pousser directement sur main) git checkout -b feat/your-feature git commit -m "feat: description" git push -u origin feat/your-feature gh pr create ``` Consultez [CLAUDE.md](CLAUDE.md) pour les consignes de dĂ©veloppement dĂ©taillĂ©es. ### Provenance et actualisation des catalogues Le rĂ©sumĂ© de catalogue versionnĂ© recense actuellement **1 934 Google Fonts approuvĂ©es** ainsi que **8 exclusions en attente de revue**, qui ne sont pas promues tant qu'elles n'ont pas de mĂ©tadonnĂ©es de licence officielles correspondantes. Les recommandations d'icĂŽnes restent Ă  **105 lignes sĂ©lectionnĂ©es** (100 imports web Phosphor directs plus des recommandations React Native/de repli) ; le **manifeste Phosphor amont de 1 512 icĂŽnes**, distinct, valide les noms, les graisses et les imports React/SSR sans inonder les rĂ©sultats de recherche avec l'intĂ©gralitĂ© du paquet amont. Le dĂ©veloppement courant et la CI des pull requests ne dĂ©pendent pas du rĂ©seau. Lancez la vĂ©rification hors ligne complĂšte, y compris les hachages des snapshots et la validation des comptes gĂ©nĂ©rĂ©s, avec : ```bash npm --prefix cli run verify:data # Ou vĂ©rifier uniquement le rĂ©sumĂ© de catalogue gĂ©nĂ©rĂ© : npm --prefix cli run validate:catalog-summary ``` La normalisation de l'actualisation peut Ă©galement ĂȘtre testĂ©e entiĂšrement hors ligne Ă  partir des fixtures versionnĂ©es. Les rĂ©sultats sont Ă©crits dans un rĂ©pertoire candidat temporaire et ne remplacent jamais les donnĂ©es canoniques : ```bash candidate_dir="$(mktemp -d)" python3 scripts/refresh-google-fonts.py \ --api-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-api.json \ --metadata-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-metadata.json \ --existing-csv src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-existing.csv \ --overrides src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-overrides.json \ --output-csv "$candidate_dir/google-fonts.csv" \ --license-output "$candidate_dir/google-font-licenses.json" \ --metadata-revision fixture-catalogs-v1 \ --verified-at 2026-08-13 --expected-count 2 --approve-changes python3 scripts/refresh-icon-catalog.py \ --input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-core.json \ --package-json src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-package.json \ --react-package-json src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-package.json \ --react-exports-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-exports.json \ --curated-csv src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/icons-curated.csv \ --output "$candidate_dir/phosphor-icons-upstream.json" \ --verified-at 2026-08-13 --expected-count 2 ``` L'actualisation en direct depuis les sources amont est volontairement isolĂ©e dans le workflow `refresh-catalogs.yml`, planifiĂ© le lundi Ă  03h17 UTC et Ă©galement disponible Ă  la demande. Configurez `GOOGLE_FONTS_API_KEY` comme secret GitHub Actions, puis lancez le workflow et tĂ©lĂ©chargez son artefact de revue : ```bash gh workflow run refresh-catalogs.yml run_id="$(gh run list --workflow refresh-catalogs.yml --limit 1 --json databaseId --jq '.[0].databaseId')" gh run watch "$run_id" gh run download "$run_id" --name "catalog-refresh-review-$run_id" ``` Le workflow interroge l'API Google Fonts Developer et les paquets Phosphor officiels Ă  version figĂ©e, Ă©crit les fichiers candidats et les diffs unifiĂ©s dans un artefact, et ne dispose que de permissions en lecture seule sur le dĂ©pĂŽt. Il ne fait jamais de commit, de push, n'ouvre jamais de PR et ne fusionne jamais rien. Examinez les rapports de modifications, les exclusions, les licences, les mĂ©triques de pertinence et la vĂ©rification hors ligne avant de promouvoir manuellement les fichiers candidats dans `src/ui-ux-pro-max/data/`. ## Releases automatisĂ©es Ce dĂ©pĂŽt utilise semantic-release avec les Conventional Commits pour crĂ©er automatiquement les releases GitHub : - La branche `dev` crĂ©e des prĂ©-versions bĂȘta GitHub, comme `2.6.0-beta.1`. - La branche `main` crĂ©e des versions stables officielles GitHub, comme `2.6.0`. Les notes de version et le `CHANGELOG.md` sont gĂ©nĂ©rĂ©s Ă  partir des messages de commit au format Conventional Commits. Les numĂ©ros de version sont synchronisĂ©s entre `skill.json`, `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json`, `cli/package.json` et `cli/package-lock.json` lors de la prĂ©paration de la release. Utilisez ces types de commit pour obtenir le bon incrĂ©ment de version : - `fix:` -> version corrective (patch) - `feat:` -> version mineure - `feat!:` ou `BREAKING CHANGE:` -> version majeure Le workflow de release utilise le `GITHUB_TOKEN` par dĂ©faut pour les releases GitHub et le secret `NPM_TOKEN` du dĂ©pĂŽt pour publier `ui-ux-pro-max-cli` sur npm. ## DĂ©pannage ### Claude Code signale `response exceeded the ... output token maximum` Il s'agit d'une limite propre Ă  une seule rĂ©ponse de Claude Code, et non d'une erreur de l'installeur ou des scripts de recherche d'UI/UX Pro Max. Demandez d'abord Ă  Claude de dĂ©couper la tĂąche en Ă©tapes plus petites et d'Ă©crire les rĂ©sultats volumineux dans des fichiers au fur et Ă  mesure. Si vous avez rĂ©ellement besoin d'une rĂ©ponse unique plus longue et que le modĂšle actif le permet, dĂ©finissez la limite de tokens de sortie de Claude Code avant de dĂ©marrer une nouvelle session. Par exemple : ```bash # macOS, Linux ou WSL export CLAUDE_CODE_MAX_OUTPUT_TOKENS="64000" claude ``` ```powershell # Windows PowerShell $env:CLAUDE_CODE_MAX_OUTPUT_TOKENS = "64000" claude ``` Les modifications de l'environnement du shell ne s'appliquent qu'aux programmes lancĂ©s depuis ce shell : redĂ©marrez donc Claude Code aprĂšs avoir dĂ©fini la variable. Claude Code plafonne les valeurs supĂ©rieures Ă  la limite de sortie du modĂšle actif ; les plafonds varient selon le modĂšle et le fournisseur. Augmenter cette valeur peut aussi accroĂźtre la latence et la consommation, et rĂ©duit le contexte effectivement disponible avant la compaction automatique. Consultez la [rĂ©fĂ©rence officielle des variables d'environnement de Claude Code](https://code.claude.com/docs/en/env-vars#variables). ### `uipro: unknown command 'uninstall'` ou `unknown command 'update'` Votre version installĂ©e de `ui-ux-pro-max-cli` est obsolĂšte. Mettez-la Ă  jour et rĂ©essayez : ```bash npm install -g ui-ux-pro-max-cli@latest uipro uninstall ``` ### `uipro uninstall` affiche « No installed AI skill directories detected » Le skill a Ă©tĂ© installĂ© dans un autre rĂ©pertoire que celui depuis lequel vous lancez la commande. Au choix : ```bash # Option A — lancer la commande depuis la racine du projet oĂč vous l'avez installĂ© cd /path/to/your/project uipro uninstall # Option B — supprimer l'installation globale uipro uninstall --global # Option C — supprimer manuellement rm -rf .claude/skills/ui-ux-pro-max # Claude Code rm -rf .cursor/skills/ui-ux-pro-max # Cursor rm -rf .windsurf/skills/ui-ux-pro-max # Windsurf rm -rf .agents/skills/ui-ux-pro-max # Antigravity / Codex ``` ### La boĂźte de dialogue « Upload a skill » de Claude.ai affiche « Zip contains too many files (maximum 200) » N'envoyez pas le ZIP complet du dĂ©pĂŽt GitHub. Il s'agit d'une copie de dĂ©veloppement qui contient le code source, les ressources de la CLI, la documentation, des aperçus et plusieurs skills intĂ©grĂ©s : elle dĂ©passe donc la limite de 200 fichiers de Claude. Ce n'est pas un artefact destinĂ© Ă  l'envoi d'un skill sur Claude, et ce projet ne publie pas actuellement de ZIP distinct pour un envoi manuel sur Claude.ai. Pour Claude Code, installez-le via la Marketplace : ```bash /plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill /plugin install ui-ux-pro-max@ui-ux-pro-max-skill ``` Ou utilisez l'installeur CLI : ```bash npx ui-ux-pro-max-cli init --ai claude ``` ### L'installation via la Claude Marketplace Ă©choue avec « Zip file contains a symbolic link » Il s'agit d'un problĂšme connu des versions antĂ©rieures Ă  la v2.5.1. Le dĂ©pĂŽt utilisait en interne des liens symboliques que certains outils d'installation ne savent pas gĂ©rer. **Solution :** utilisez plutĂŽt l'installeur CLI : ```bash npm install -g ui-ux-pro-max-cli uipro init --ai claude ``` Ou attendez la prochaine version, dans laquelle ce problĂšme est corrigĂ©. ### `npm install -g ui-ux-pro-max-cli` Ă©choue avec une erreur de permissions Utilisez un gestionnaire de versions de Node (recommandĂ©), ou Ă©vitez complĂštement l'installation globale : ```bash # npx sans installation globale npx ui-ux-pro-max-cli init --ai claude ``` ### Python introuvable lors de l'exĂ©cution des commandes de design system Les scripts de recherche nĂ©cessitent Python 3.x. Installez-le manuellement depuis [python.org](https://www.python.org/downloads/) ou avec le gestionnaire de paquets de votre systĂšme (Homebrew, apt, winget). Les agents IA ne doivent pas l'installer Ă  votre place : ils ont pour consigne de vous le demander. ### La sortie du design system est coupĂ©e / les champs sont tronquĂ©s La sortie lisible par un humain tronque les champs longs Ă  300 caractĂšres. Utilisez `--json` pour obtenir les donnĂ©es complĂštes, sans troncature : ```bash python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS" --domain style --json ``` --- ## Historique des Ă©toiles [![Graphique de l'historique des Ă©toiles](https://star-history.dera.page/svg?repos=nextlevelbuilder/ui-ux-pro-max-skill&type=Date)](https://star-history.dera.page/#nextlevelbuilder/ui-ux-pro-max-skill&Date) ## Licence Ce projet est distribuĂ© sous [licence MIT](LICENSE). ## Agents compatibles Ce skill fonctionne avec : - [Claude Code](https://claude.com/product/claude-code) - [AdaL](https://sylph.ai/) - Agent de programmation IA auto-Ă©volutif ([Documentation](https://docs.sylph.ai/) | [GitHub](https://github.com/SylphAI-Inc/adal-cli))