Toluwalope AkinkunmiChargement…

Je griffonne…

000
Aller au contenu
← Toutes les notes

· 2 min de lecture

Partager la logique, pas les écrans

Ce qui est entré dans le paquet partagé entre les apps Next.js et Expo d'une plateforme d'événements, ce qui en est resté dehors, et pourquoi.

La plateforme d'événements a commencé comme une app web. À l'arrivée de l'app mobile, le plus rapide était de recopier les appels d'API et les règles. En quelques semaines, les deux apps divergeaient sur de petites choses importantes : comment formater un montant en nairas, quels statuts de commande comptent comme payés, quand un organisateur peut demander un versement.

Un paquet, trois règles

Les deux apps sont passées dans un monorepo npm workspaces avec un seul paquet partagé. Il suit trois règles :

  • Partager ce qui doit concorder : services d'API, hooks de requêtes, schémas de validation, formatage des montants, correspondance des statuts et règles métier comme l'éligibilité aux versements.
  • Ne pas partager les écrans. L'interface de chaque app reste native à sa plateforme : aucune ne ressemble à un portage de l'autre.
  • Aucun import spécifique à une plateforme dans le code partagé. Un module qui a besoin du DOM ou d'une API native n'a pas sa place dans le paquet.
Deux apps, un paquet partagé.Public et organisateurs → App web; Public et organisateurs → App mobile; App web → Paquet partagé; App mobile → Paquet partagé; Paquet partagé → API de la plateforme; API de la plateforme ↔ VersementsPublic et organisateursApp webNext.jsApp mobileExpoPaquet partagénpm workspacesAPI de la plateformeRESTVersementsStripeimporteimporterequêtes typées
Deux apps, un paquet partagé.

Le plus dur, ce sont les dépendances

Le code a bougé facilement. Les versions, non. React, TanStack Query et la bibliothèque de validation doivent se résoudre aux mêmes versions pour les deux apps, et le hoisting des paquets ne se comporte pas pareil pour Next.js et Metro. Les versions sont alignées à un seul endroit, et les changements de lockfile sont vérifiés en revue.

Est-ce que ça valait le coup ?

Oui. Changer le moment où un versement peut être demandé se fait désormais dans un seul fichier, et les deux apps en profitent. Web et mobile ne peuvent plus diverger sur l'argent, et cela seul a justifié le déménagement.

Note suivanteUne seule connexion pour plusieurs appsComment une famille de produits est passée à un service de connexion unique en OAuth 2.0, et les règles qui le gardent sûr.