> ## 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 la commande de développement desktop 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/desktop, 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 le .env racine pour les commandes de migration de base de données et apps/web/.env.local pour le backend Web — dans un checkout uniquement Desktop, ce fichier appartient au dépôt de backend séparé. Le shell desktop ne lit pas les fichiers .env : SUPASTACK_APP_URL est un paramètre d'environnement de terminal que vous passez en ligne de commande au démarrage, pas une configuration stockée dans un fichier. 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/desktop/project-structure.md) ## Gardez la commande dev en cours ; utilisez un autre terminal pour les commandes La commande de développement desktop compile le shell Rust et ouvre la fenêtre pendant son exécution. Laissez son terminal ouvert pendant que vous testez la fenêtre. 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 du shell, arrêtez la commande desktop avec Ctrl + C et relancez-la. Le cœur Rust se recompile à chaque démarrage ; modifier SUPASTACK_APP_URL signifie passer la nouvelle valeur à la prochaine exécution, pas éditer un fichier enregistré. ``` corepack pnpm --filter @supastack/desktop 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/desktop/troubleshooting.md) ## Suivant [Laissez un agent faire l'installation](https://supastack.dev/fr/docs/desktop/agent-setup.md)