> ## 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

Découvrez où coller les commandes, comment ouvrir le bon dossier de projet, modifier les fichiers .env, arrêter un serveur 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 affiche uniquement le contenu de apps/web ou apps/mobile, tapez cd ../.. et appuyez sur Entrée pour revenir à la racine. S'il affiche votre dossier personnel, tapez cd suivi d'un espace et du chemin complet de votre clone, entre guillemets lorsqu'il contient des espaces. Ouvrir le dossier du projet dans l'éditeur et créer un nouveau terminal est généralement plus simple.

```
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 root .env pour les commandes de migration de base de données, apps/web/.env.local pour le serveur Web Next.js et apps/mobile/.env.local pour Expo. Next et Expo s'exécutent dans leurs propres dossiers d'application et ne chargent pas automatiquement le fichier racine .env. Si une connexion à une base de données change, mettez à jour DATABASE_URL dans root .env et apps/web/.env.local afin que les migrations et le serveur utilisent la même base de données. Conservez le fichier d’exemple inchangé pour référence future.

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/web/project-structure.md)


## Gardez le serveur en marche ; utiliser un autre terminal pour les commandes

Le serveur de développement sert votre application pendant que vous travaillez. Laissez son terminal ouvert lorsqu'un didacticiel indique ouvrir localhost:3000. localhost désigne cet ordinateur ; :3000 est le port, comme une porte numérotée utilisée par l'application. Placez le URL dans la barre d'adresse de votre navigateur, pas dans le terminal.

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 de l'environnement Web, arrêtez et redémarrez le serveur Web avec la commande ci-dessous. L'enregistrement d'un fichier source actualise normalement la page automatiquement, mais les modifications de l'environnement nécessitent un redémarrage. Après avoir modifié les paramètres de Expo, arrêtez Expo, puis exécutez le corepack pnpm --filter @supastack/mobile start --clear pour redémarrer et effacer son bundle mis en cache.

```
corepack pnpm --filter @supastack/web dev
```


## 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/web/troubleshooting.md)


## Suivant

[Laissez un agent faire l'installation](https://supastack.dev/fr/docs/web/agent-setup.md)