04 / The Circular Net
Circular Ticket
Un produit d'événements et de billetterie : le public découvre des événements et achète des billets ; les organisateurs créent leurs événements, scannent les billets à l'entrée et sont payés en NGN ou en USD.
- Entreprise
- The Circular Net
- Rôle
- Frontend web en solo
- Période
- mars 2026 – Aujourd'huiEn ligne
- Liens
- Voir le site
- Stack
- Next.jsReact 19TypeScriptTailwind CSSnpm workspacesTanStack QueryTanStack TableRedux ToolkitZodStripe
Circular Ticket
Site + app web pour les événements et la billetterie
Captures d'écran bientôt
Ce que j'ai construit
- 01Pages publiques d'événements avec métadonnées SEO, plan du site et images OG
- 02Un assistant de création d'événement en plusieurs étapes : programme, types de billets, intervenants et lieux hybrides
- 03Scan de billets dans le navigateur, hub de scan et accès scanner pour le personnel
- 04Portefeuilles NGN/USD, transactions, comptes de versement et demandes de versement
- 05Un parcours KYC en cinq étapes et les réglages de vérification des organisateurs
- 06Commandes, statistiques d'inscription et export tableur pour les organisateurs
Le système
Deux apps, un paquet partagé
Décisions clés
- 01
Partager la logique, pas les écrans
Le paquet partagé contient services, hooks, schémas et règles. L'interface reste native à chaque plateforme : aucune des deux apps ne ressemble à un portage de l'autre.
- 02
Une règle, un seul endroit
L'éligibilité aux versements, la correspondance des statuts de commande et le formatage des montants n'existent qu'une fois. Web et mobile ne peuvent pas diverger sur l'argent.
- 03
Concevoir chaque état
Chargement, erreur, vide après filtre et vide réel sont des états distincts sur chaque écran de données. Les tableaux de bord denses des organisateurs sont devenus bien plus lisibles.
01
Le problème
Les organisateurs avaient besoin d'un seul endroit pour publier, vendre des billets, gérer les entrées, vérifier leur identité et être payés. Les apps web et mobile dupliquaient les appels d'API et les règles métier, et divergeaient peu à peu.
02
La démarche
J'ai d'abord construit l'app web, puis je l'ai déplacée dans un monorepo npm workspaces avec une nouvelle app Expo. Services, hooks de requêtes, schémas de validation et règles comme le formatage des montants ou l'éligibilité aux versements sont passés dans un paquet partagé ; les écrans restent propres à chaque plateforme. Chaque domaine (événements, commandes, portefeuilles, versements, KYC, scan) est relié à l'API en production, y compris l'onboarding Stripe et les virements bancaires.
03
Le résultat
L'app web est en ligne sur circularticket.com. Les deux apps importent les mêmes services et règles : une modification, par exemple du moment où un versement peut être demandé, ne se fait qu'une fois.
04
Ce que j'en retiens
Partager du code est d'abord un problème de dépendances. Des versions alignées et un hoisting maîtrisé entre web et natif ont compté davantage que le code partagé lui-même.