Rénovation UI de projets existants : moderniser React et web sans tout casser
Générer une démo de zéro est facile ; rénover une application en production sans casser les contrats d'API, la validation de formulaires ni l'état d'URL est l'endroit où les prompts IA directs échouent. La voie sûre consiste à verrouiller d'abord la logique métier non négociable, suivre une portée de rénovation étape par étape, parcourir la tâche réelle en comptant les clics et extraire un DESIGN.md partagé depuis le premier écran abouti.
Points clés à retenir
Verrouillez d'abord les invariants métier
listez les payloads API, paramètres de route et gestionnaires de formulaires auxquels l'agent ne doit pas toucher.
Rénovez en trois étapes claires
l'étape 1 retire le bruit de bordures et couleurs, l'étape 2 améliore hiérarchie et états manquants, l'étape 3 condense les chaînes de modales multi-pages.
À retenir 3
Vérifiez l'ergonomie en comptant les clics — ramener une boucle de fiche détail en 8 clics à 2 actions par lot en ligne vaut mieux qu'un simple ravalement cosmétique.
À retenir 4
Dès que votre écran phare passe la revue, consignez ses tokens, son échelle typographique et ses espacements dans DESIGN.md pour aligner toutes les routes voisines.
- Clics pour terminer
- 2étapes
- Changements de page
- 0pages
- Risque de retour en arrière
- Zéro saut · aperçu scindé + lot et annulation en 1 clic
Zhou Yu · Librairie Xiaoman
Salon du livre d’automne et cartes de membre
- Dernier envoi
- 06 oct. · Proposition initiale envoyée
- Statut
- En attente de réponse client
« La maquette pour le salon du livre d’automne et les cartes de membre est prête pour relecture. Avec une validation cette semaine, nous tiendrons le calendrier de la prochaine étape. »
Trois étapes de rénovation UI : choisir le rayon d'action
Les équipes hésitent souvent à laisser un agent de code toucher aux vues en production parce qu'un prompt vague comme « rends cette page plus belle » peut altérer des props ou supprimer des filtres actifs. Dans Oil UI (et spécifiquement dans le workflow projet existant d'Oil UI Pro), les rénovations suivent trois paliers explicites :
| Étape | Quand l'utiliser | Ce qui change | Ce qui reste intact |
|---|---|---|---|
| Étape 1 : Nettoyer le bruit visuel | Le parcours fonctionne, mais bordures, tailles de texte, espacements et couleurs paraissent encombrés ou datés | Échelle typographique, suppression de bordures, alignement, retenue des couleurs et allégement des cartes | Structure DOM, routes, hooks d'état et chaque flux d'interaction |
| Étape 2 : Améliorer mise en page et états | La hiérarchie visuelle est plate, les actions clés sont enfouies ou les états chargement/vide/erreur manquent | Hiérarchie de sections, proportions multi-colonnes, points de rupture responsives et états UI complets | Contrats d'API backend, logique métier et navigation inter-pages |
| Étape 3 : Refondre les parcours lourds et extraire DESIGN.md | Les utilisateurs enchaînent des modales empilées ou des écrans fragmentés pour des tâches simples | Fusion d'étapes, édition en ligne, refonte de l'écran phare et DESIGN.md à l'échelle du dépôt | Modèle de domaine sous-jacent et règles d'intégrité des données |
Quatre étapes pour rénover une application en production sans risque
Que vous modernisiez une app de revue de contrats (comme MOQI dans la galerie), un suivi de sprints (Relay), un client mail (Post) ou un parcours de paiement (Pinch Checkout), suivez une séquence maîtrisée :
Capturer l'écran actuel et produire un diagnostic annoté
Demandez d'abord à l'agent de capturer la page en cours d'exécution et de lister les défauts visuels et d'interaction numérotés (par exemple : trois boutons primaires en concurrence dans l'en-tête, un tableau à 12 colonnes tronqué en 1280px ou des boîtes alert() brutes en cas d'erreur).
Rénover d'abord un seul écran phare
Ne touchez pas vingt routes d'un coup. Choisissez l'écran où les utilisateurs passent le plus de temps, comparez 2 à 3 directions de rénovation avec de vraies données et verrouillez la gagnante.
Parcourir la tâche utilisateur complète et compter les clics
Cliquez et saisissez dans le parcours réel du navigateur — filtrer, soumettre, déclencher une erreur de validation et corriger. Vérifiez que les tâches fréquentes demandent moins d'étapes qu'avant.
Extraire DESIGN.md et déployer sur les pages voisines
Une fois l'écran phare validé visuellement, demandez à l'agent d'écrire sa palette de surfaces, son échelle typographique, sa densité de tableaux et ses règles anti-clichés dans DESIGN.md, puis appliquez cette spécification au reste de l'application.
Modèle de prompt pour rénover un écran existant
Utilisez cette structure dans Claude Code, Codex ou Cursor pour mettre à niveau une vue en production tout en protégeant votre logique applicative :
Utilise Oil UI pour rénover [route ou chemin du composant, ex. : app/billing/page.tsx] dans ce projet.
- Comportement à préserver strictement : Conserve intacts tous les [requêtes de données, paramètres de filtre URL, règles de validation de formulaire et gestionnaires d'envoi/export] existants. Ne supprime aucun champ métier.
- Problèmes actuels à corriger : [ex. : chaque section ressemble à une carte bordurée identique ; les colonnes de tableau passent mal à la ligne ; les états filtre vide et échec de paiement manquent].
- Palier de rénovation : [Choisir : Étape 1 nettoyer le bruit / Étape 2 améliorer mise en page et états / Étape 3 refondre le parcours et extraire DESIGN.md].
Commence par capturer et diagnostiquer l'écran actif actuel, propose des directions et vérifie la page terminée en 1440×900 et 390×844.Lister les comportements préservés dès le premier point évite les régressions accidentelles.
Exemples fonctionnels et prompts de la galerie
Parcourir la collection →Rénover des applications en production sereinement avec Oil UI Pro
Les prompts de refonte vagues cassent souvent des filtres actifs et des gestionnaires de formulaire. Oil UI Pro diagnostique d'abord votre écran en direct à partir de captures, rénove en trois étapes contrôlées, compte les clics sur la tâche réelle et extrait un DESIGN.md pour tout le dépôt ($19.99 en achat unique).
Découvrir Oil UI Pro →npx github:oil-oil/oil-cli install oil-ui-proQuestions fréquentes
Faut-il définir des tokens CSS globaux d'abord ou rénover un premier écran réel ?
Rénovez d'abord un écran représentatif. Les fichiers de tokens abstraits écrits dans le vide résistent rarement à la densité réelle des tableaux et aux états de formulaires. Peaufiner un écran phare avec de vraies données rend l'extraction de tokens précis dans DESIGN.md évidente.
Puis-je rénover une application existante progressivement sans réécrire des widgets tiers ?
Oui. Une passe d'étape 1 ou d'étape 2 peut réorganiser la grille de page, la typographie, les espacements et les états alentour tout en laissant des widgets embarqués complexes intacts jusqu'à ce que vous soyez prêt à les remplacer.
Comment vérifier qu'une refonte a réellement amélioré l'ergonomie ?
Vérifiez deux choses : d'abord, floutez le texte pour confirmer que l'action principale et les états d'exception ressortent structurellement ; ensuite, accomplissez la tâche utilisateur principale dans le navigateur et vérifiez que nombre de clics, défilement et reprise d'erreur sont plus rapides qu'avant.
Où placer DESIGN.md une fois extrait ?
Conservez DESIGN.md à la racine de votre dépôt ou dans docs/. Dès que vous ou un collègue développez une nouvelle fonctionnalité dans Claude Code, Codex ou Cursor, indiquez DESIGN.md à l'agent pour que les nouveaux écrans s'alignent sur le système établi.


