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

# Commando's, bestanden en configuratie

Leer waar u opdrachten plakt, hoe u de juiste projectmap opent, .env-bestanden bewerkt, een server stopt en een installatiefout rapporteert zonder geheimen te delen.

## Er komt een commando in de terminal

Een terminal is het venster waarin u instructies voor uw computer typt. Open in Visual Studio Code eerst uw supastack-map met Bestand → Map openen en selecteer vervolgens Terminal → Nieuwe terminal. De nieuwe terminal begint in die map. Kies in Windows PowerShell via het menu naast de + knop van de terminal. Gebruik macOS/Linux-blokken in een macOS- of Linux-terminal.

Plak alleen de inhoud van een opdrachtblok, één opdracht tegelijk, en druk op Enter. Plak niet de omringende Markdown-markeringen, een prompt zoals PS C:\... of voorbeelduitvoer. Regels die beginnen met # zijn uitleg; ze voeren niets uit. Wacht tot elke installatieopdracht is voltooid voordat u de volgende opdracht invoert. Een serveropdracht blijft actief en retourneert pas een nieuwe prompt als u deze stopt.


## Controleer welke map de terminal gebruikt

Repository root betekent de supastack-map op het hoogste niveau met daarin package.json, pnpm-workspace.yaml, apps en pakketten. Tenzij een stap anders zegt, voert u daar opdrachten uit. Met de onderstaande opdracht wordt de huidige map afgedrukt; de bestandslijst zou package.json moeten tonen. In Windows werken PowerShell pwd en ls ook.

Als de lijst alleen de inhoud van apps/web of apps/mobile toont, typt u cd ../.. en drukt u op Enter om terug te keren naar de hoofdmap. Als uw thuismap wordt weergegeven, typt u cd gevolgd door een spatie en het volledige pad naar uw kloon, tussen aanhalingstekens als deze spaties bevat. Het openen van de projectmap in de editor en het maken van een nieuwe terminal is meestal eenvoudiger.

```
pwd
ls
```


## De configuratie gaat in een bestand, niet in de terminal

Een blok zoals AI_PROVIDER=fake is configuratietekst. Open het genoemde .env-bestand in de editor, zoek de regel die begint met AI_PROVIDER=, vervang de waarde ervan en sla deze op met Ctrl + S (Command + S op macOS). Elke instelling beslaat één regel in de vorm KEY=value. Voeg geen Markdown-backticks toe. Vermijd dubbele kopieën van dezelfde sleutel in één bestand.

Gebruik root .env voor opdrachten voor databasemigratie, apps/web/.env.local voor de Next.js-webserver en apps/mobile/.env.local voor Expo. Next en Expo draaien in hun eigen app-mappen en laden root .env niet automatisch. Als een databaseverbinding verandert, update dan DATABASE_URL in zowel root .env als apps/web/.env.local, zodat migraties en de server dezelfde database gebruiken. Laat het voorbeeldbestand ongewijzigd voor toekomstig gebruik.

Bestanden waarvan de naam met een punt begint, zijn mogelijk verborgen in uw bestandsbeheerder; de Verkenner van de redacteur toont ze. Zorg ervoor dat de bestandsnaam exact .env.local is, en niet .env.local.txt. Deze lokale bestanden kunnen wachtwoorden bevatten en zijn uitgesloten van Git; upload ze niet en plak de inhoud ervan niet in ondersteuningsberichten.

[Vind de betekenis van elke instelling](https://supastack.dev/nl/docs/web/project-structure.md)


## Houd de server draaiende; gebruik een andere terminal voor opdrachten

De ontwikkelserver bedient uw app terwijl u werkt. Laat de terminal open wanneer een tutorial open localhost:3000 zegt. localhost betekent deze computer; :3000 is de poort, zoals een genummerde deur die door de app wordt gebruikt. Plaats de URL in de adresbalk van uw browser, niet in de terminal.

Als u nog een opdracht wilt uitvoeren terwijl de server actief is, selecteert u Terminal → Nieuwe terminal in de editor. De nieuwe terminal is een apart venster in hetzelfde project. Om de server te stoppen, selecteert u de terminal en drukt u één keer op Ctrl + C. Als u in Windows wordt gevraagd Batchtaak beëindigen, typt u Y en drukt u op Enter. Wacht op de normale melding voordat u hem opnieuw start.

Na het bewerken van de webomgevingsinstellingen stopt u de webserver en start u deze opnieuw op met de onderstaande opdracht. Als u een bronbestand opslaat, wordt de pagina normaal gesproken automatisch vernieuwd, maar wijzigingen in de omgeving moeten opnieuw worden opgestart. Na het bewerken van de Expo-instellingen stopt u Expo en voert u vervolgens corepack pnpm --filter @supastack/mobile start --clear uit om opnieuw op te starten en de cachebundel te wissen.

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


## Lees een fout en vraag om nuttige hulp

Als een installatie een rode fouttekst retourneert, stop dan bij die stap. Lees de eerste fout in plaats van door te gaan met het starten van de app. Commando niet gevonden betekent meestal een ontbrekend gereedschap; geen package.json betekent meestal de verkeerde map; ECONNREFUSED betekent meestal dat een vereiste server of database niet actief is; EADDRINUSE betekent dat een ander proces de poort al gebruikt.

Als u om hulp vraagt, vermeld dan uw besturingssysteem, de handleiding URL en het stapnummer, de exacte opdracht die u hebt ingevoerd en de eerste foutmelding. Verwijder wachtwoorden, API-sleutels, tokens en het wachtwoordgedeelte van elke database URL. Stuur uw .env-bestanden niet. Een screenshot van de fout kan helpen, maar kopieerbare tekst is gemakkelijker te diagnosticeren.

[Problemen met een specifieke installatiefout oplossen](https://supastack.dev/nl/docs/web/troubleshooting.md)


## Volgende

[Laat een agent het inrichten](https://supastack.dev/nl/docs/web/agent-setup.md)