Skip to main content
Créez des expériences natives iOS, Android et web pour Whop à partir d’une seule base de code React Native. Vos apps s’exécutent directement dans l’app mobile Whop et peuvent accéder aux fonctionnalités natives de la plateforme.

Fonctionnement

Whop intègre les apps React Native sous forme d’expériences qui s’exécutent sur plusieurs plateformes :
  • Mobile (iOS/Android) : les apps s’exécutent en natif dans l’app mobile Whop avec une intégration complète à la plateforme
  • Web : les apps s’exécutent dans le navigateur avec des solutions de repli automatiques pour les fonctionnalités propres à chaque plateforme
  • Code universel : écrivez une fois, déployez partout, avec des optimisations propres à chaque plateforme
Votre app reçoit le contexte de l’utilisateur authentifié et peut effectuer des appels API via le SDK Whop. Le système de build gère automatiquement le bundling propre à chaque plateforme, avec Metro pour le mobile et esbuild pour le web.

Premiers pas

Configuration requise

Avant de commencer, assurez-vous que votre système respecte les exigences suivantes : Pour vérifier, exécutez node -v et pnpm -v.

Créer votre app

Créez une nouvelle app Whop React Native avec la CLI :
Cette commande crée un nouveau projet avec la structure suivante :

Configurer les variables d’environnement

Créez un fichier .env.local à la racine du projet :
Obtenez ces identifiants depuis le tableau de bord développeur Whop :
  1. Accédez au tableau de bord développeur Whop
  2. Créez une nouvelle app ou sélectionnez-en une existante
  3. Copiez les variables d’environnement depuis les paramètres de l’app

Vues

Structure du projet
Les apps Whop utilisent différentes « vues » selon l’endroit où elles sont affichées. Chaque vue reçoit le contexte authentifié sous forme de props.

Vue d’expérience

La vue principale des apps d’expérience. C’est là que les utilisateurs interagissent avec le contenu de votre app.
Props :
  • experienceId - L’ID de l’expérience
  • companyId - Le compte propriétaire de cette expérience
  • currentUserId - L’utilisateur authentifié (ou null s’il n’est pas connecté)
  • path - Chemin de navigation sous forme de tableau (p. ex. ["courses", "123"])
  • params - Paramètres de requête sous forme d’objet

Vue du tableau de bord

Pour les intégrations au tableau de bord du compte, où les vendeurs gèrent leur entreprise.
Props :
  • companyId - L’ID du compte
  • currentUserId - L’utilisateur authentifié
  • path - Chemin de navigation sous forme de tableau
  • params - Paramètres de requête

Vue Discover (facultative)

Pour les expériences de marketplace/découverte, où les utilisateurs parcourent du contenu.

Récupérer des données

Utiliser le SDK Whop

Cet exemple utilise une interface SDK obsolète. Il sera mis à jour à la sortie du nouveau SDK React Native.
Le SDK Whop est disponible d’emblée pour récupérer des données côté client :
TanStack Query est un bon choix pour récupérer des données, car il gère automatiquement la mise en cache, les états de chargement et les nouvelles récupérations.
Certaines opérations du SDK sont réservées au serveur (« server only ») et doivent être appelées depuis votre API. Consultez le guide de démarrage rapide pour savoir quelles méthodes nécessitent une exécution côté serveur.

Effectuer des requêtes API authentifiées

Pour les opérations côté serveur, créez des routes API et appelez-les depuis votre app React Native :
1

Définissez l'URL de base de votre API

Configurez l’origine de votre API dans le tableau de bord développeur sous Base URL.
URL de base
2

Créez un endpoint API

Consultez le guide de démarrage rapide pour la configuration du SDK.
3

Appelez-le depuis React Native

Utilisez apiOrigin pour effectuer des requêtes authentifiées :
Il est important d’utiliser apiOrigin pour les requêtes authentifiées. Cela garantit que les requêtes passent par le proxy de Whop avec les en-têtes d’authentification appropriés.

Exemple : vérifier l’accès à une expérience

Cet exemple côté serveur utilise une interface SDK obsolète. Pour la vérification actuelle des jetons côté serveur avec @whop/sdk, consultez Authentification.

Style

Thèmes de couleur

React Native fournit un hook useColorScheme pour détecter le thème de couleur de l’appareil. Il fonctionne automatiquement dans les apps Whop :

Utiliser les couleurs Radix UI

Pour un système de couleurs complet avec mode sombre automatique, utilisez le modèle de hook useColors avec les couleurs Radix UI :
Utilisation :

Utilisez les API de navigation internes pour naviguer entre les écrans et afficher des modales :
Whop transmet path et params sous forme de props à votre composant de vue.

Revenir en arrière

Afficher une feuille ou une modale

Obtenir la route actuelle


Fonctionnalités propres à chaque plateforme

Configurez le titre et la description de la barre de navigation :

Orientation de l’écran

Contrôlez l’orientation de l’écran :

Retour haptique

Fournissez un retour haptique sur les appareils mobiles :
Types de retour haptique disponibles :
  • "selection" - Retour léger de sélection
  • "impactLight" | "impactMedium" | "impactHeavy" - Retour d’impact
  • "notificationSuccess" | "notificationWarning" | "notificationError" - Retour de notification

Cache local

Stockez des données localement sur l’appareil :

Détails de l’app hôte

Obtenez des informations sur l’app Whop :

Achats in-app

Acceptez des paiements directement dans votre app :
Pour un guide complet sur l’acceptation des paiements, consultez la documentation Accepter des paiements.

Utiliser des bibliothèques tierces

La plupart des bibliothèques React Native fonctionnent d’emblée. Voici les versions recommandées des bibliothèques courantes :
Lorsque vous ajoutez de nouvelles bibliothèques, assurez-vous qu’elles sont compatibles avec React Native. Certains paquets npm sont réservés au web et ne fonctionnent pas sur les plateformes mobiles.

Déploiement

Build et déploiement

La commande ship compile votre app pour toutes les plateformes et la téléverse en tant que build de développement :
Compiler pour des plateformes spécifiques :
La commande ship déploie un build de développement, que vous pouvez exécuter sans risque sur des apps déjà en production. Il n’affecte pas vos utilisateurs actuels.

Builds de développement et de production

Builds de développement :
  • Déployés avec pnpm ship
  • Visibles uniquement lorsque vous activez le Dev mode (secouez le téléphone)
  • Testables sans risque, sans affecter les utilisateurs en production
  • Déployables à tout moment
Builds de production :
  • Promus à partir des builds de développement via le tableau de bord
  • Visibles par tous les utilisateurs
  • Nécessitent une approbation/revue
  • À tester avant la promotion

Prévisualiser votre app

Après avoir déployé un build de développement, prévisualisez-le sur votre appareil :
Cette commande génère un QR code qui installe votre app.
Pour prévisualiser les builds de développement, vous devez secouer votre téléphone pour activer le Dev mode dans l’app Whop. Cela vous permet de voir les builds hors production.

Commandes de build

Commandes supplémentaires pour gérer les builds :

Promouvoir en production

  1. Déployez un build de développement : pnpm ship
  2. Testez en Dev mode (secouez pour l’activer)
  3. Accédez au tableau de bord de votre app
  4. Ouvrez l’onglet Builds
  5. Sélectionnez votre build de développement
  6. Sélectionnez Promote to Production
Promouvoir en production
Whop examine votre app et la déploie auprès de tous les utilisateurs après approbation.

Retour arrière

Depuis l’écran des builds, vous pouvez aussi revenir instantanément à un build de production précédent et le mettre en ligne pour tous les utilisateurs de Whop.
Retour arrière

Référence de l’interface en ligne de commande

La CLI @whop/react-native fournit des commandes pour compiler et déployer votre app :

Commandes

Processus de build

Lorsque vous exécutez pnpm ship, la CLI :
  1. Génère les points d’entrée - Crée des fichiers d’entrée propres à chaque plateforme qui enregistrent vos vues
  2. Bundle le code :
    • Mobile (iOS/Android) : utilise le bundler Metro + le compilateur de bytecode Hermes
    • Web : utilise esbuild avec les alias React Native Web
  3. Empaquette les ressources - Collecte et optimise les images et autres ressources
  4. Téléverse sur Whop - Crée un build de développement dans le tableau de bord de votre app
  5. Génère un lien d’installation - Fournit un QR code pour les tests

Sortie du build


Dépannage

Le build de développement ne s’affiche pas

Problème : vous avez déployé un build de développement mais vous ne le voyez pas dans l’app. Solution : secouez votre téléphone pour activer le Dev mode. Les builds de développement ne sont visibles que lorsque le Dev mode est actif.

Échecs de build

Problème : le build échoue avec des erreurs Metro ou esbuild. Solutions :
  • Exécutez pnpm clean pour vider le cache de build
  • Vérifiez que vous avez installé toutes les dépendances : pnpm install
  • Vérifiez la version de Node.js : node -v (doit être 22+)
  • Recherchez des erreurs de syntaxe dans vos vues

Les requêtes vers l’interface de programmation ne fonctionnent pas

Problème : les requêtes API renvoient une erreur 401 ou des erreurs d’authentification. Solutions :
  • Vérifiez que vous utilisez apiOrigin issu de __internal_execSync("getAppApiOrigin", {})
  • Vérifiez que .env.local définit WHOP_API_KEY
  • Confirmez que votre endpoint API appelle whopSdk.verifyUserToken(request.headers)
  • Vérifiez que l’URL de base est correctement définie dans le tableau de bord

Vues introuvables

Problème : le build réussit mais les vues ne s’affichent pas. Solutions :
  • Vérifiez que les fichiers de vue existent dans src/views/
  • Vérifiez que les exports correspondent : export function ExperienceView(props: ExperienceViewProps)
  • Assurez-vous que les fichiers de vue se terminent par .tsx ou .jsx

Les bibliothèques ne fonctionnent pas

Problème : une bibliothèque tierce provoque des plantages sur mobile. Solutions :
  • Vérifiez que la bibliothèque prend en charge React Native (pas seulement le web)
  • Utilisez les versions recommandées de la section Utiliser des bibliothèques
  • Vérifiez si la bibliothèque nécessite des modules natifs (si c’est le cas et qu’elle ne figure pas dans la liste recommandée, elle n’est pas prise en charge)

Problèmes propres à une plateforme

Problème : l’app fonctionne sur une plateforme mais pas sur une autre. Solutions :
  • Utilisez Platform.OS pour détecter la plateforme et prévoir des solutions de repli
  • Testez sur toutes les plateformes avant de promouvoir en production
  • Vérifiez que vous n’utilisez pas incorrectement des API propres à une plateforme

Étapes suivantes