> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Commandes, fichiers et configuration Apprenez où coller les commandes, comment ouvrir le bon dossier de projet, modifier les fichiers .env, arrêter le serveur Expo et signaler une erreur de configuration sans partager de secrets. ## Une commande va dans le terminal Un terminal est la fenêtre dans laquelle vous tapez des instructions pour votre ordinateur. Dans Visual Studio Code, ouvrez d'abord votre dossier supastack en utilisant Fichier → Ouvrir le dossier, puis sélectionnez Terminal → Nouveau terminal. Le nouveau terminal démarre dans ce dossier. Sous Windows, choisissez PowerShell en utilisant le menu à côté du bouton + du terminal. Utilisez des blocs macOS/Linux dans un terminal macOS ou Linux. Collez uniquement le contenu d'un bloc de commandes, une commande à la fois, et appuyez sur Entrée. Ne collez pas les backticks Markdown environnants, une invite telle que PS C:\... ou un exemple de sortie. Les lignes commençant par # sont des explications ; ils ne gèrent rien. Attendez la fin de chaque commande d'installation avant de saisir la commande suivante. Une commande serveur continue de s'exécuter et ne renvoie pas de nouvelle invite jusqu'à ce que vous l'arrêtiez. ## Vérifiez quel dossier le terminal utilise La racine du référentiel désigne le dossier supastack de niveau supérieur contenant package.json, pnpm-workspace.yaml, les applications et les packages. Sauf indication contraire dans une étape, exécutez les commandes ici. La commande ci-dessous imprime le dossier actuel ; la liste des fichiers doit afficher package.json. Sous Windows, PowerShell pwd et ls fonctionnent également. Si la liste n'affiche que le contenu d'apps/mobile, tapez cd ../.. et appuyez sur Entrée pour revenir à la racine. Si elle affiche votre dossier personnel, tapez cd suivi d'un espace et du chemin complet vers votre clone, entre guillemets s'il contient des espaces. Il est généralement plus simple d'ouvrir le dossier du projet dans l'éditeur et de créer un nouveau terminal. ``` pwd ls ``` ## La configuration va dans un fichier, pas dans le terminal Un bloc comme AI_PROVIDER=fake est un texte de configuration. Ouvrez le fichier .env nommé dans l'éditeur, recherchez la ligne commençant par AI_PROVIDER=, remplacez sa valeur et enregistrez par Ctrl + S (Command + S sur macOS). Chaque paramètre occupe une ligne sous la forme KEY=value. N'ajoutez pas de backticks Markdown. Évitez les copies en double de la même clé dans un seul fichier. Utilisez apps/mobile/.env.local pour Expo et le .env racine pour les commandes de migration de base de données. Expo ne charge pas automatiquement le .env racine. Le backend Web lit son propre apps/web/.env.local ; dans un checkout uniquement Mobile, ce fichier appartient au dépôt de backend séparé, pas à celui-ci. Si l'adresse du backend change, mettez à jour EXPO_PUBLIC_API_URL dans apps/mobile/.env.local et redémarrez Expo. Gardez le fichier d'exemple inchangé pour référence. Les fichiers dont les noms commencent par un point peuvent être masqués dans votre gestionnaire de fichiers ; l'explorateur de l'éditeur les montre. Assurez-vous que le nom du fichier est exactement .env.local, et non .env.local.txt. Ces fichiers locaux peuvent contenir des mots de passe et sont exclus de Git ; ne les téléchargez pas et ne collez pas leur contenu dans les messages d'assistance. [Trouver la signification de chaque paramètre](https://supastack.dev/fr/docs/mobile/project-structure.md) ## Gardez le serveur en marche ; utiliser un autre terminal pour les commandes Le serveur de développement Expo livre vos écrans à un téléphone ou un simulateur pendant que vous travaillez. Laissez son terminal ouvert lorsqu'un tutoriel demande de scanner le code QR. Une commande de serveur continue de s'exécuter et ne rend pas un nouveau prompt tant que vous ne l'arrêtez pas. Pour exécuter une autre commande pendant que le serveur est actif, sélectionnez Terminal → Nouveau terminal dans l'éditeur. Le nouveau terminal est une fenêtre distincte dans le même projet. Pour arrêter le serveur, sélectionnez son terminal et appuyez une fois sur Ctrl + C. Sous Windows, si on vous demande Terminer le travail par lots, tapez Y et appuyez sur Entrée. Attendez l'invite normale avant de recommencer. Après avoir modifié les paramètres d'Expo, arrêtez-le avec Ctrl + C, puis exécutez la commande ci-dessous pour le redémarrer et vider le bundle en cache. Enregistrer un fichier source actualise normalement l'aperçu automatiquement, mais les changements d'environnement nécessitent le redémarrage. ``` corepack pnpm --filter @supastack/mobile start --clear ``` ## Lire un échec et demander une aide utile Si une installation renvoie un texte d'erreur rouge, arrêtez-vous à cette étape. Lisez la première erreur plutôt que de continuer à lancer l'application. Commande introuvable signifie généralement un outil manquant ; no package.json signifie généralement le mauvais dossier ; ECONNREFUSED signifie généralement qu'un serveur ou une base de données requis n'est pas en cours d'exécution ; EADDRINUSE signifie qu'un autre processus utilise déjà le port. Lorsque vous demandez de l'aide, incluez votre système d'exploitation, le guide URL et le numéro d'étape, la commande exacte que vous avez saisie et le premier message d'erreur. Supprimez les mots de passe, les clés API, les jetons et la partie mot de passe de toute base de données URL. N'envoyez pas vos fichiers .env. Une capture d'écran de l'erreur peut aider, mais le texte copiable est plus facile à diagnostiquer. [Résoudre un échec de configuration spécifique](https://supastack.dev/fr/docs/mobile/troubleshooting.md) ## Suivant [Laissez un agent faire l'installation](https://supastack.dev/fr/docs/mobile/agent-setup.md)