Commando's, bestanden en configuratie

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/desktop toont, typ dan cd ../.. en druk op Enter om terug te keren naar de root. Als het je thuismap toont, typ dan cd gevolgd door een spatie en het volledige pad naar je kloon, tussen aanhalingstekens als het spaties bevat. Het is meestal makkelijker om de projectmap in de editor te openen en een nieuwe terminal te maken.

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 de root-.env voor database-migratiecommando's en apps/web/.env.local voor de Web-backend — in een alleen-Desktop-checkout hoort dat bestand bij de aparte backend-repository. De desktop-shell leest geen .env-bestanden: SUPASTACK_APP_URL is een terminal-omgevingsinstelling die je op de commandoregel meegeeft bij het starten, geen configuratie opgeslagen in een bestand. Houd het voorbeeldbestand ongewijzigd als referentie.

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

Houd het dev-commando draaiend; gebruik een andere terminal voor commando's

Het desktop-ontwikkelcommando compileert de Rust-shell en opent het venster terwijl het draait. Laat zijn terminal open terwijl je het venster test. Een servercommando blijft draaien en geeft geen nieuwe prompt terug totdat je het stopt.

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.

Stop het desktop-commando na het wijzigen van shell-instellingen met Ctrl + C en voer het opnieuw uit. De Rust-kern compileert opnieuw bij elke start; SUPASTACK_APP_URL wijzigen betekent de nieuwe waarde meegeven bij de volgende run, geen opgeslagen bestand bewerken.

corepack pnpm --filter @supastack/desktop 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