Oil UI
Guide par scénario · Rénovation de projet existant

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
Branche · Correspondance
File sans réponse (3)
06 oct.
08 oct.
09 oct.
2 sélectionné(s)
CONTEXTE DU MESSAGE

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. »
Installer Oil UI Pro pour le workflow complet de diagnostic et rénovation en 3 étapes
npx github:oil-oil/oil-cli install oil-ui-pro

Pour tester d'abord les tableaux de directions et le nettoyage anti-clichés sur un seul écran, exécutez npx skills add oil-oil/oil-ui pour le skill gratuit.

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 :

Les trois étapes de rénovation d'un projet existant dans Oil UI
ÉtapeQuand l'utiliserCe qui changeCe qui reste intact
Étape 1 : Nettoyer le bruit visuelLe 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 cartesStructure DOM, routes, hooks d'état et chaque flux d'interaction
Étape 2 : Améliorer mise en page et étatsLa hiérarchie visuelle est plate, les actions clés sont enfouies ou les états chargement/vide/erreur manquentHiérarchie de sections, proportions multi-colonnes, points de rupture responsives et états UI completsContrats d'API backend, logique métier et navigation inter-pages
Étape 3 : Refondre les parcours lourds et extraire DESIGN.mdLes utilisateurs enchaînent des modales empilées ou des écrans fragmentés pour des tâches simplesFusion d'étapes, édition en ligne, refonte de l'écran phare et DESIGN.md à l'échelle du dépôtModè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 :

  1. 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).

  2. 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.

  3. 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.

  4. 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 :

Modèle de prompt de rénovation UI de projet existant
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 →
Oil UI Pro

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 →
Copier le prompt d'installation Pro
npx github:oil-oil/oil-cli install oil-ui-pro

Questions 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.

Guides associés

Guide UI Cursor et Windsurf ↗Éliminer les clichés visuels de l'IA ↗Revue à l'aveugle sur écran réel ↗