Que fait screenshot-to-compose ?
Reproduire un design fidèlement en Compose sans approximation. L’image de référence est le test d’acceptation, donc chaque nombre utilisé est soit observé (mesuré sur l’image) soit inféré (une hypothèse que vous déclarez), et l’écran final est comparé à la référence à la fin.
Quand le design est l’entrée
- Captures d’écran/maquettes uniquement : suivre toutes les phases ci-dessous.
- Maquettes Figma disponibles : ignorer la phase de mesure (lire les valeurs depuis Figma) et garder le reste.
- Pas encore de design : utiliser d’abord le skill
app-design-studio, puis revenir ici.
Workflow
Travail dans les fichiers (docs/design/), un écran à la fois après la mise en place des fondations partagées. Ne rien implémenter tant que tout l’inventaire des écrans n’est pas compris.
- Inspecter. Lire d’abord le dépôt (architecture, thème, composants partagés, écrans existants). Conserver ce qui fonctionne. Noter les hypothèses.
- Inventaire. Copier les références sans les modifier dans
docs/design/reference/(noms en kebab-case). RédigerSCREEN_INVENTORY.md: chaque image → écran + état, liens entre écrans, références manquantes (un écran lié mais non montré), taille en pixels et rapport hauteur/largeur. Inclure tous les états : chargement, vide, erreur, hors ligne, permission, premium. - Mesurer. Exécuter
scripts/measure_image.py shot.png --frame-dp 390 --sample x,y ...pour l’échelle px→dp et les échantillons de couleur (references/measuring.md). Les pixels ne sont pas des dp : supposer un cadre de 390 dp sauf indication contraire,dp = px / (largeurImagePx / 390). Enregistrer les valeurs observées et inférées dans des colonnes séparées. - Système de design. Mapper les couleurs mesurées aux rôles Material 3, échelle typographique, formes, espacements dans le thème. Les écrans n’utilisent que les tokens du thème (pas de hex, tailles ou rayons dans les écrans). Définir les modes clair et sombre ; si seul le clair existe, dériver le sombre sans modifier la mise en page.
- Ressources (
references/assets.md). Icônes : une seule famille, récupérées depuis Iconify, converties avecscripts/svg_to_vectordrawable.py. Illustrations : les générer, ne jamais les rogner des captures d’écran. Le texte, les boutons, les cartes, les anneaux et les graphiques sont toujours en Compose, jamais en images. Enregistrer la source, la licence, le modèle et le prompt dansASSET_INVENTORY.md. - Planifier. Pour chaque écran, décider à l’avance : comportement retour, classe réseau/hors ligne, permissions, scroll ou fit sur les petits téléphones, animations. Rédiger
SCREEN_IMPLEMENTATION_PLAN.mdavec l’ordre de construction. (Les règles de qualité pour ces aspects se trouvent dans le skillandroid-compose-quality-gate.) - Implémenter d’abord les fondations partagées, puis les écrans : composables sans état sur un état UI immuable, ViewModel avec intentions, un composable par fichier, ressources chaînes pour tout le texte. Paralléliser uniquement les modules indépendants avec des fichiers disjoints. Lire
references/compose-lessons.mdavant de construire des cartes, des tuiles ou du texte serré. - Comparer (
references/verification.md). Générer le rendu de l’écran (capture d’écran d’émulateur ou Roborazzi), le placer à côté de la référence à largeur égale avecscripts/compare_side_by_side.py, lister les différences de mise en page, espacement, typographie, couleurs, formes et ressources, corriger, répéter. Ensuite vérifier sur les petits appareils (360 x 526 dp), texte long/allemand, RTL, sombre, échelle de police 1.3. Ne jamais sacrifier la fonctionnalité ou la réactivité pour une correspondance pixel parfaite. - Livrer. Garder les références, les ressources avec leurs prompts, les sources/licences d’icônes, les inventaires et les notes de comparaison à jour. Un écran n’est terminé que lorsqu’il fonctionne et passe la comparaison visuelle. Commiter par sujet.
Règles qui empêchent les échecs habituels
- Ne jamais rogner des images des captures de référence (basse résolution, compressées, UI intégrée).
- Ne jamais remplacer l’UI native par une image de celle-ci.
- Ne jamais inventer un design quand la référence est ambiguë : faire l’inférence la plus raisonnable, l’écrire dans la colonne inférée, rester proche de la référence.
- Ne pas déclarer un écran terminé avant qu’il ait été exécuté et comparé.
- Pas de secrets (clés API) dans le dépôt ou la documentation ; les clés de service d’image proviennent de l’environnement.
Fichiers
references/measuring.md– px vers dp, échantillonnage de couleurs, tableaux observé vs inféré.references/assets.md– Iconify vers VectorDrawable, ordre de génération et revue des images, tailles d’exportation, autres sources.references/compose-lessons.md– défauts qui coûtent du temps réel : ratios de cartes frères, plantage de mesure intrinsèque, seuils de largeur, texte à auto-dimensionnement.references/verification.md– boucle de comparaison émulateur vs Roborazzi et la matrice d’appareils.scripts/measure_image.py,scripts/svg_to_vectordrawable.py,scripts/compare_side_by_side.py(Python 3 + Pillow).