Aller au contenu
supastack
Parcourir la documentation
MobileExpo

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /fr/docs/mobile/local-setup.md (or send Accept: text/markdown).

Exécuter l’application mobile

Connectez Expo à une API de développement accessible.

Poser une question sur ce guide
Ouvrir dans

1. Préparez l'ordinateur, le téléphone et le backend

Terminer Avant de démarrer et d'ouvrir le référentiel mobile ou le monorepo toutes plateformes dans votre éditeur. Dans Terminal → Nouveau terminal à la racine du référentiel, exécutez la commande d'installation ci-dessous. Attendez que ça se termine. Installez Expo Go sur votre téléphone en utilisant la page officielle Expo liée ci-dessous ; sa version doit prendre en charge la version Expo SDK enregistrée dans apps/mobile/package.json.

Un backend est le serveur Web qui gère la connexion, les données de l'espace de travail et les requêtes IA. Si votre paiement contient apps/web, exécutez d'abord la configuration Web dans un autre terminal et laissez ce serveur fonctionner. Terminez sa configuration Postgres avant d’essayer une inscription ou une connexion native. Une caisse mobile uniquement ne contient pas apps/web : connectez-la plutôt à votre backend en cours d'exécution, fourni séparément. Le démarrage de Expo démarre le serveur de prévisualisation d'écran, pas le backend.

Mettez votre téléphone et votre ordinateur sur le même réseau Wi-Fi. Déconnectez temporairement un VPN s'il bloque les connexions locales. Le localhost d'un téléphone désigne le téléphone lui-même. Utilisez l'adresse réseau privée de votre ordinateur pour un téléphone physique ou un appareil Android ; Le simulateur iOS sur le même Mac peut utiliser http://localhost:3000, et l'émulateur Android utilise généralement http://10.0.2.2:3000..

corepack pnpm install

2. Recherchez et testez l'adresse du backend

Sous Windows, exécutez ipconfig dans un nouveau terminal PowerShell, recherchez votre adaptateur Wi-Fi actif et lisez l'adresse IPv4. Sur macOS, ouvrez Paramètres système → Wi-Fi → Détails → TCP/IP et lisez l'adresse IP. Sous Linux, ouvrez vos paramètres réseau et lisez l'adresse IPv4. Une adresse peut ressembler à 192.168.1.25 ; le vôtre sera généralement différent.

Si l'adresse de votre ordinateur est 192.168.1.25, ouvrez http://192.168.1.25:3000 dans le navigateur du téléphone pendant que le serveur Web est en cours d'exécution. Remplacez votre adresse réelle. La page d'accueil doit se charger avant de continuer. Autorisez l'application Node sur les réseaux privés si le pare-feu Windows le demande. S'il ne se charge pas, vérifiez l'adresse, le Wi-Fi, le pare-feu et le serveur Web en cours d'exécution ; un tunnel Expo ne transporte que le bundle de prévisualisation et ne rend pas votre API séparé accessible.

# Windows PowerShell only:
ipconfig

3. Créez le fichier de configuration de l'application mobile

Dans l'explorateur de l'éditeur, développez applications → mobile, créez un nouveau fichier nommé .env.local et collez la configuration ci-dessous dans ce fichier. Remplacez 192.168.1.25 par l'adresse que vous venez de tester ou utilisez l'adresse backend HTTPS fournie. Enregistrez le fichier. Son chemin complet est apps/mobile/.env.local ; root .env n'est pas automatiquement lu par Expo.

Gardez le paramètre d'achat du téléphone désactivé pour le premier aperçu. EXPO_PUBLIC_ signifie qu'un paramètre est inclus dans l'application téléphonique. Ces valeurs doivent donc contenir uniquement des URL publiques, des schémas et des paramètres clients publics. Ne collez pas ici les secrets du fournisseur d'IA, de la base de données ou de la facturation. Le serveur Web possède son propre apps/web/.env.local ; changer le fichier Mobile ne change pas le serveur.

EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=supastack
EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=off

4. Démarrez Expo et ouvrez l'aperçu

Depuis la racine du référentiel, exécutez la commande ci-dessous. Attendez un code QR et le message d'attente Metro. Gardez ce terminal et le terminal backend ouverts. Sur Android, ouvrez Expo Go et scannez le code QR ; sur iPhone, utilisez Appareil photo, scannez le code et ouvrez-le dans Expo Go. Le code QR ouvre l'application de développement, pas votre page d'accueil backend.

Le succès signifie que l'écran de connexion de l'application s'ouvre sur votre appareil. Avec les achats réduits, il s'agit d'un aperçu de l'interface utilisateur ; terminez la configuration de l'authentification Web basée sur la base de données avant de tester la connexion, les espaces de travail enregistrés ou le chat. Si votre cible est un simulateur installé, appuyez sur a dans le terminal Expo pour Android ou i pour iOS. iOS Simulator nécessite macOS et Xcode ; il ne peut pas fonctionner sous Windows.

corepack pnpm --filter @supastack/mobile start

5. Récupérez des erreurs d'aperçu et testez les flux réels

Si Expo Go signale un projet incompatible, comparez son SDK pris en charge avec apps/mobile/package.json et utilisez la version compatible de la page officielle Expo. Ne mettez pas à niveau les versions de dépendance du kit simplement pour ignorer le message. Si un module natif requis n’est pas disponible, suivez les versions mobiles pour une version de développement contenant ce module.

Si la connexion échoue en raison d'une erreur réseau, réessayez d'abord le backend URL dans le navigateur du téléphone. Si le URL fonctionne mais que la connexion échoue, inspectez le terminal principal et vérifiez le Postgres et les migrations. La session de démonstration locale/dashboard ne vous connecte pas par téléphone. Si la configuration semble obsolète, appuyez sur Ctrl + C dans le terminal Expo, puis exécutez la commande de redémarrage ci-dessous et rouvrez l'aperçu.

Expo Go ne peut pas prouver le comportement réel d'achat/restauration de StoreKit ou Play Billing. Suivez les achats intégrés et les versions mobiles pour une version de développement EAS et stockez des comptes de test. Les premières versions natives et l’inscription du compte peuvent prendre plus de cinq minutes. Pour arrêter cet aperçu, appuyez sur Ctrl + C dans le terminal Expo ; arrêtez le backend séparément lorsque vous avez terminé.

corepack pnpm --filter @supastack/mobile start --clear

Pour poursuivre la configuration, consultez Authentification native.

Questions fréquentes

14 questions

Qu'est-ce que supastack ?

supastack est une fondation modulaire pour construire des produits SaaS avec IA. Elle réunit l'infrastructure commune pour que vous puissiez vous concentrer sur les fonctionnalités propres à votre produit.

Prend-il en charge le web et le mobile ?

Oui. supastack inclut des applications Next.js et Expo comme points de départ pour des expériences web et mobile.

Quelle authentification est incluse ?

Better Auth couvre e-mail/mot de passe, OTP et connexion sociale. Les espaces de travail personnels sont provisionnés avec le compte pour que les enregistrements restent délimités dès le premier jour.

Comment l'IA est-elle prise en charge ?

supastack inclut une IA multi-fournisseurs configurable, le suivi d'usage, des budgets, et la prise en charge chiffrée de vos propres clés (BYOK).

Comment les abonnements sont-ils gérés ?

Pour les produits construits sur le kit, la facturation Stripe, les abonnements et les droits d'accès forment la base de l'accès payant. Les secrets fournisseur restent côté serveur.

Où vit le code propre à mon produit ?

Les fonctionnalités propres au produit restent dans un codebase séparé, tandis que le produit configure et intègre les modules de la fondation supastack.

Comment fonctionne la tarification de supastack ?

Le kit est un achat unique avec mises à jour à vie : Un framework à 249 $ (prix de lancement temporaire — 100 $ de réduction par rapport au prix habituel de 349 $) ou Tous les frameworks (Next.js, iOS, Android) à 499 $ (prix de lancement temporaire — 100 $ de réduction par rapport au prix habituel de 599 $), plus 75 $ par siège développeur supplémentaire. Pas d'abonnement au kit. Le paiement sur ce site livre votre clé de licence par e-mail, avec accès au dépôt via invitation GitHub.

Comment les espaces de travail délimitent mes données ?

Les enregistrements appartenant aux utilisateurs sont délimités par workspaceId. Identité, droits d'accès, usage IA, événements de facturation et entrées d'audit restent dans le périmètre de l'espace personnel.

Comment fonctionnent les jobs en arrière-plan ?

Trigger.dev est le runtime de jobs explicite. Le contrat JobRunner ne promet que enqueue, status et cancel — la sémantique de workflow reste propre à Trigger.dev et explicite.

En quoi l'e-mail diffère-t-il de la prospection ?

L'e-mail transactionnel couvre les flux produit comme les avis de fin de tâche. La prospection à froid et les campagnes relèvent du produit, hors du module e-mail de ce kit.

Comment fonctionnent les achats sur mobile ?

Le mobile inclut les achats natifs et leur restauration via RevenueCat, avec un accès vérifié par votre serveur. Configurez les comptes des boutiques et terminez les tests sur appareil avant publication. La facturation web reste séparée.

Où vivent les clés des fournisseurs IA ?

Les identifiants BYOK sont chiffrés et restent côté serveur. Les clés sont masquées dans les journaux ; l'usage et les budgets restent visibles au niveau de l'espace de travail.

Quels moyens de paiement le checkout accepte-t-il ?

Le checkout hébergé par Stripe accepte les cartes et peut aussi proposer Alipay et WeChat Pay une fois ces portefeuilles activés sur le compte Stripe — pratique pour les acheteurs en Chine. Les autorisations de portefeuille se confirment de manière asynchrone : la page de licence se met à jour dès que le paiement est validé.

Puis-je obtenir un remboursement ?

Une fois que vous avez accès au dépôt, supastack vous appartient pour toujours et ne peut donc pas être remboursé. Mais rassurez-vous : vous obtenez le code source complet avec des mises à jour à vie pour créer et déployer un nombre illimité de produits pour vous ou vos clients. Vous ne pouvez simplement pas revendre le code ni redistribuer le dépôt sous forme de kit de démarrage ou de modèle.

FR
Thème