←Tous les articles
Jeu. 19 novembre 2026·7 min de lecture

📾 Expo Explore : la revue visuelle des Ă©crans Ă  chaque PR

Schéma Expo Explore : une PR ouverte, la sélection des écrans touchés par le diff et le routeur, le build base et head, la capture sur Expo Simulators, la comparaison avant/aprÚs et le commentaire posté sur la PR

📚 Introduction

CĂŽtĂ© web, la rĂ©gression visuelle est rĂ©glĂ©e depuis des annĂ©es : un navigateur headless photographie chaque page, compare avec la rĂ©fĂ©rence, et la PR affiche les pixels qui ont bougĂ©. Sur mobile, il faut builder l’app, dĂ©marrer un simulateur, naviguer jusqu’au bon Ă©cran, puis tout refaire pour la branche de base. Alors on colle des captures Ă  la main dans la PR. Quand on y pense.

Explore est la rĂ©ponse d’Expo Ă  ce trou. Le dĂ©pĂŽt se prĂ©sente lui-mĂȘme comme un outil expĂ©rimental, publiĂ© sous licence MIT, et le paquet npm @expo/explore en Ă©tait Ă  la 0.23.0 fin octobre 2026. Il arrive dans la foulĂ©e d’Expo Simulators, les simulateurs cloud d’Expo, sur lesquels tourne sa CI.

Je fais surtout du backend PHP et du DevOps. Ce qui m’intĂ©resse, c’est le pipeline : comment choisir les Ă©crans Ă  photographier Ă  partir d’un diff, et ce qu’on peut confier Ă  un agent qui « explore » une app.

🔎 Qu’est-ce que fait Expo Explore, concrùtement ?

Deux choses, qui partagent le mĂȘme format de rapport.

La premiĂšre, c’est revoir un changement. Sur chaque pull request, Explore lit le diff, en dĂ©duit les Ă©crans touchĂ©s, builde la base et la tĂȘte, capture ces Ă©crans sur un simulateur et poste un commentaire sur la PR avec les Ă©crans ajoutĂ©s, supprimĂ©s ou modifiĂ©s. Ça demande le code source de l’app : Expo SDK 57 ou plus, avec Expo Router (57+) ou React Navigation (6+), et un compte Expo, puisque les builds passent par Expo Services.

La seconde, c’est explorer un build. On lui donne un .app, un .apk ou un .ipa simulateur, de n’importe quelle app, et Claude Code ou Codex le parcourt en tapant sur les boutons. Il en sort une carte : une vignette par Ă©cran atteint, reliĂ©e aux autres par le contrĂŽle tapĂ© pour y arriver. Sans le source, il n’y a Ă©videmment pas d’avant/aprĂšs.

Commentaire posté par Explore sur une pull request de l'app euxy : 2 écrans changés, un lien « Review in Explore », les rapports par appareil (iPhone 17, trois poses d'iPhone Duo, Android) et la route /tempo avec le texte ajouté

Le commentaire de PR tel que le montre le README d’Explore, sur l’app de dĂ©mo euxy.

đŸ§© Du diff aux Ă©crans : le pipeline

La partie la plus intĂ©ressante se passe avant le moindre simulateur. Explore construit un plan.json Ă  partir du source, sans exĂ©cuter l’app : l’inventaire des routes vient des fichiers et layouts d’Expo Router, ou des dĂ©clarations JSX statiquement lisibles de React Navigation. Il croise ce graphe avec le diff git exact entre les deux commits et suit les dĂ©pendances jusqu’aux Ă©crans. Puis il ajoute les routes situĂ©es Ă  un pas de navigation avant ou aprĂšs une route touchĂ©e.

Un dĂ©tail m’a plu : un fichier JS ou TS dont les deux versions donnent le mĂȘme arbre syntaxique, Ă  des commentaires ou des espaces prĂšs, n’atteint aucun Ă©cran. Reformater un fichier ne dĂ©clenche donc pas une capture complĂšte. Et avant d’allouer le moindre simulateur, la CI rĂ©gĂ©nĂšre le plan dans des processus neufs et compare les octets : si les deux plans divergent, le job Ă©choue avec le diff.

Schéma du pipeline Expo Explore : PR ouverte, sélection des écrans touchés à partir du diff et du routeur, build base et head sur Expo Build, capture sur Expo Simulators, comparaison avant/aprÚs, commentaire sur la PR

CĂŽtĂ© capture, deux modes. Le mode dĂ©terministe, recommandĂ© pour dĂ©marrer, ouvre chaque Ă©cran par deep link, avec des Ă©tapes de prĂ©paration fixes dans .expo-explore/config.yaml (remplir un champ, taper sur « Continuer »). Le mode agent confie la navigation Ă  Claude Code ou Codex, guidĂ© par un fichier d’instructions en anglais, et l’agent tente de se rattraper quand l’interface surprend. Il coĂ»te en plus l’usage du modĂšle, facturĂ© par Anthropic ou OpenAI.

Le simulateur est pilotĂ© par agent-device (par dĂ©faut) ou Argent. Un build est rĂ©utilisĂ© tant que l’empreinte native ne change pas, et la base reprend la « baseline » de la branche principale quand elle existe.

Vue Screens d'un rapport Explore sur la PR #163 d'euxy : 7 écrans changés sur 19, arbre des routes à gauche avec une pastille par statut, grille des captures à droite

🚀 DĂ©marrer en local

La premiĂšre prise en main se fait sur sa machine, sans CI. Il faut Node.js 24.12 ou plus, et un profil de build simulateur dans eas.json :

{ "build": { "explore": { "ios": { "simulator": true } } } }

Ensuite, on modifie un texte en haut d’un Ă©cran (Explore ne capture que ce qui s’affiche sans scroller) et on lance :

npx @expo/explore capture                     # sur Expo Simulators
npx @expo/explore capture --simulator local   # ou sur un simulateur du Mac

Explore builde le dernier commit et les modifications en cours sur Expo Services, capture avant et aprĂšs, puis ouvre le rapport. Pour cartographier un build existant :

npx @expo/explore explore:binary ./my-app.app
npx @expo/explore explore:binary ./my-app.apk --simulator local

Une exploration s’arrĂȘte par dĂ©faut aprĂšs 15 minutes, 40 Ă©crans ou 150 actions, et ne tape jamais un bouton qui supprime, paie, dĂ©connecte, envoie ou quitte l’app. Un mot de passe de test passe par {{secret:NAME}} dans --hints : le modĂšle ne voit que la rĂ©fĂ©rence. Pour un parcours identique Ă  chaque run, --replay steps.json rejoue des Ă©tapes Ă©crites une fois, sans modĂšle.

Carte d'exploration de l'app euxy : une vignette par écran atteint, disposées selon le nombre de taps depuis le lancement, chaque lien légendé par le contrÎle tapé

đŸ› ïž Brancher la CI GitHub Actions

npx @expo/explore setup Ă©crit .expo-explore/config.yaml et les workflows. npx @expo/explore doctor liste ensuite ce qui manque, avec l’action Ă  mener, jusqu’à sortir en code 0. Reste Ă  poser le secret EXPO_TOKEN, merger sur la branche par dĂ©faut (la baseline tourne au push) et ouvrir une PR. Le README fournit aussi un prompt qui fait faire tout ça Ă  Claude Code ou Codex.

Si vous avez déjà monté une pipeline GitHub Actions pour une app Laravel, rien de dépaysant : un job de capture par plateforme, un rapport en artefact gardé 30 jours, un seul commentaire sur la PR. explore-compare.yml compare aussi deux commits quelconques, une release candidate contre la derniÚre stable par exemple.

Le rapport parle aussi aux agents. Le mĂȘme lien sert l’interface Ă  un navigateur, et un index Markdown (aussi sous /llms.txt) Ă  tout client qui ne demande pas de HTML, avec une API JSON en lecture seule :

curl -s "$LINK/api/v1/screens?status=modified" | jq '.items[] | {route, status, review}'

Un agent peut donc trier changements voulus et rĂ©gressions, et nommer le fichier Ă  corriger. Avec des agents qui codent en parallĂšle, comme dans Orca, c’est la boucle qui manquait : vĂ©rifier le rendu de ce qu’ils ont Ă©crit.

⚠ Quelques prĂ©cautions

  • ExpĂ©rimental. C’est Ă©crit dans la description du dĂ©pĂŽt, et les versions s’enchaĂźnent vite : de la 0.1.0 le 2 octobre 2026 Ă  la 0.23.0 le 30 octobre.
  • Liste d’attente obsolĂšte. Le README prĂ©sente encore Expo Simulators comme « in preview », avec une liste d’attente. Depuis l’annonce du 12 novembre 2026, le service est disponible sur tous les plans payants, Ă  0,10 $ la minute, avec 60 minutes par mois incluses sur les plans Starter, Production et Enterprise jusqu’en 2027. Sans plan payant, reste --simulator local, mais la CI capture toujours sur Expo Simulators.
  • Le code des deux commits s’exĂ©cute chez vous. Une revue locale installe les dĂ©pendances, Ă©value la config et bundle le JavaScript des deux commits. Ne lancez pas capture sur une branche dont vous ne feriez pas tourner le code.
  • Pas de PR de forks, et Android a moins servi qu’iOS, de l’aveu mĂȘme du README.
  • Pas de pixels figĂ©s. DonnĂ©es, heure et rĂ©seau ne sont pas gelĂ©s : deux captures du mĂȘme commit peuvent diffĂ©rer. Un Ă©cran derriĂšre une connexion demande un compte de test et des Ă©tapes de prĂ©paration.
  • Ce qui tient Ă  l’écran, sans scroll, et une capture par apparence (clair, sombre). Les modales et autres Ă©tats sont prĂ©vus pour plus tard.

🎉 Conclusion

Explore applique Ă  React Native une idĂ©e que le web pratique depuis longtemps, avec un vrai travail sur la sĂ©lection des Ă©crans : le diff et le graphe de navigation dĂ©cident de ce qu’on photographie, sans liste Ă  maintenir. Pour une Ă©quipe Expo dĂ©jĂ  sur Expo Router ou React Navigation et sur un plan payant, l’essai coĂ»te une commande en local, puis un setup et quelques passages de doctor pour la CI.

Je le garderais pour l’instant hors des checks bloquants. L’outil est jeune, les captures ne sont pas dĂ©terministes au pixel prĂšs, et la valeur tient surtout au commentaire de PR : un relecteur voit enfin ce que le changement donne Ă  l’écran sans checkout ni simulateur. CĂŽtĂ© Laravel, c’est le genre de filet que Pest 4 et son browser testing apportent en testant dans un vrai navigateur.

🔗 Liens utiles

/faq

Questions fréquentes

Qu'est-ce qu'Expo Explore ?

+

Un outil expérimental d'Expo, sous licence MIT et publié sur npm sous le nom @expo/explore. Sur chaque pull request, il capture les écrans que le changement peut affecter, avant et aprÚs, sur Expo Simulators, puis poste un commentaire qui renvoie vers un rapport visuel. Il peut aussi cartographier un build existant en le faisant parcourir par Claude Code ou Codex.

Quels sont les prérequis pour utiliser Expo Explore ?

+

Node.js 24.12 ou plus récent. Pour revoir un changement : une app Expo SDK 57 ou plus avec Expo Router (57+) ou React Navigation (6+), et un compte Expo, car l'app est buildée sur Expo Services. Pour explorer un build : un build simulateur de n'importe quelle app et un accÚs Claude Code ou Codex (ou une clé API).

Faut-il Expo Simulators pour utiliser Explore ?

+

Non. L'option --simulator local capture sur un simulateur iOS (Xcode 26+) ou un émulateur Android créé sur votre Mac. Mais la CI GitHub Actions, elle, capture toujours sur Expo Simulators, ouvert à tous les plans payants Expo depuis le 12 novembre 2026.

Explore remplace-t-il les tests end-to-end ?

+

Non. Explore photographie la partie visible de chaque écran touché et compare les pixels : il signale ce qui a changé visuellement, pas si un parcours fonctionne. Les données, l'heure et le réseau ne sont pas figés, donc deux captures peuvent différer sans régression.