For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /nl/docs/web/before-you-start.md (or send Accept: text/markdown).
Voordat je begint
Installeer Node.js, Git en een editor, accepteer uw repository-uitnodiging, download de kit en controleer of uw computer klaar is voor de eerste run.
1. Kies wat je wilt uitvoeren
Gebruik een Windows-, macOS- of Linux-computer met een internetverbinding. Een browser voert de webapp uit; een telefoon voert de mobiele app uit; de Desktop-app wordt in een eigen venster geopend. Uw telefoon alleen kan de onderstaande installatiestappen niet uitvoeren.
Een repository is de map met bestanden die u via GitHub hebt ontvangen. Web-, mobiele- en desktopaankopen bieden elk de bijbehorende kitrepository; de All Platforms-bundel biedt de monorepo, een map met alle drie de apps. Accepteer de uitnodiging voor de repository die u hebt gekocht. Voor een mobiele of desktopkassa is nog steeds een bereikbare webbackend nodig: de server die accounts en gegevens verwerkt. Deze clientopslagplaatsen omvatten niet de webserver.
Bereid deze hulpmiddelen één keer voor. Het downloaden van tools en de eerste native compilatie kan veel langer dan vijf minuten duren. Na deze voorbereidingen beginnen de vijf minuten durende gidsen; Als u lokaal draait, wordt uw app niet op internet gepubliceerd.
2. Installeer Node.js
Open hieronder de officiële Node.js-downloadpagina. Kies een LTS-versie met nummer 22 of hoger en het installatieprogramma voor uw computer: .msi op Windows of .pkg op macOS. Open het gedownloade installatieprogramma, behoud de standaardinstellingen en voltooi de installatie. Met Node.js kan uw computer het JavaScript van de app uitvoeren; npm wordt ermee geïnstalleerd.
Sluit en open uw terminal opnieuw na de installatie. Open in Windows Start, typ PowerShell en open het. Op macOS drukt u op Command + Spatie, typ Terminal en druk op Enter. Op Linux open je Terminal vanuit je applicatiemenu. Plak de onderstaande opdracht en druk vervolgens op Enter. Een resultaat zoals v22.x.x of v24.x.x bevestigt dat Node beschikbaar is. Als u ziet dat de opdracht niet is gevonden of niet wordt herkend, opent u de terminal opnieuw of installeert u Node opnieuw met de PATH-optie ingeschakeld.
node --version
npm --version3. Installeer Git en een teksteditor
Open de onderstaande Git-downloadpagina, selecteer uw besturingssysteem en volg het installatieprogramma. Git downloadt je privérepository en registreert bestandswijzigingen. Op macOS kan het uitvoeren van de onderstaande opdracht de installatie van Apple's opdrachtregelprogramma's opleveren; accepteer het en voer de opdracht opnieuw uit nadat deze is voltooid. Gebruik op Linux de installatieopdracht die voor uw distributie op de Git-pagina wordt weergegeven.
Installeer Visual Studio Code vanaf de officiële downloadpagina. Dit is een teksteditor voor het openen van het project en het opslaan van configuratiebestanden. Open het, kies Bestand → Map openen (Bestand → Openen op macOS) en selecteer later de supastack-map die u downloadt. U hoeft geen code te schrijven om de eerste lokale demonstratie te voltooien.
Voer in een nieuw geopende terminal de onderstaande opdracht uit. Een resultaat dat begint met de git-versie betekent dat Git klaar is. Als de opdracht ontbreekt, voltooi dan het installatieprogramma en open de terminal opnieuw.
git --version4. Accepteer uw GitHub-uitnodiging
Meld u in uw browser aan bij GitHub met het account dat u bij aankoop heeft opgegeven. Open uw GitHub-uitnodigingsmail, selecteer Uitnodiging bekijken en accepteer toegang. Open vervolgens de uitgenodigde repository. Je zou de bestanden en een groene codeknop moeten zien. Een 404 betekent meestal dat de uitnodiging niet is geaccepteerd of dat u bent ingelogd op een ander GitHub-account.
Selecteer Code → Lokaal → HTTPS en kopieer het weergegeven adres. Gebruik dat exacte adres in de volgende stap. Voorbeeldadressen met punthaken zijn sjablonen: vervang ze in plaats van de haakjes te plakken. U hoeft geen organisatienaam te raden of de privérepository openbaar te maken.
5. Download het project naar uw computer
Kies een map voor uw projecten, zoals Documenten. Open die map in Verkenner of Finder. Klik in Windows met de rechtermuisknop op een leeg gebied en kies Openen in terminal. Kies vervolgens indien nodig PowerShell. Open op macOS Terminal, typ cd gevolgd door een spatie, sleep de map naar de terminal en druk op Enter. De terminal werkt nu in die map.
Vervang in de eerste opdracht hieronder YOUR_COPIED_HTTPS_ADDRESS door het HTTPS-adres dat u zojuist hebt gekopieerd. Voer één regel tegelijk uit. De eerste regel maakt een nieuwe map aan met de naam supastack; de tweede regel komt erin. Als Git je vraagt om in te loggen, voltooi dan de browseraanmelding. Gebruik het wachtwoord van uw GitHub-account niet als Git-wachtwoord. Als inloggen bij de browser niet beschikbaar is, volgt u de HTTPS-authenticatiegids van GitHub, die hieronder is gelinkt.
Succes: de map supastack bevat package.json, pnpm-workspace.yaml, apps en pakketten. Dit is de root van de repository. Als Git zegt dat de bestemming al bestaat, gebruik dan een andere lege map of open de bestaande kloon; verwijder uw werk niet. Houd deze terminal open voor de volgende stap.
git clone YOUR_COPIED_HTTPS_ADDRESS supastack
cd supastack6. Controleer Corepack en de vastgezette pakketbeheerder
Voer de eerste opdracht hieronder uit. Corepack selecteert de pnpm-versie die is vastgelegd in package.json; pnpm downloadt de bibliotheken die het project gebruikt. Als Corepack toestemming vraagt om die versie te downloaden, typt u y en drukt u op Enter. Deze kassa pint pnpm 11.19.0; behoud de pincode in plaats van een andere pakketbeheerder te kiezen.
Als corepack ontbreekt, voer dan npm install --global corepack uit, open uw terminal opnieuw en probeer het opnieuw. Als PowerShell zegt dat een npm.ps1- of corepack.ps1-script niet kan worden uitgevoerd, gebruik dan npm.cmd of corepack.cmd voor die opdracht, inclusief corepack.cmd pnpm install. U hoeft het uitvoeringsbeleid van uw computer niet te wijzigen.
De gefilterde opdrachten die voor het eerst worden uitgevoerd, roepen Corepack rechtstreeks aan. Als je een Turbo-opdracht zoals corepack pnpm dev gebruikt, heeft Turbo ook een pnpm-opdracht nodig op PATH. De onderstaande Windows-installatie maakt die opdracht aan in een door de gebruiker beschrijfbare map; de PATH-wijziging geldt alleen voor de huidige terminal. Voer dit blok opnieuw uit nadat u een nieuwe terminal hebt geopend als pnpm ontbreekt. Voer op macOS/Linux corepack enable uit; als er een toestemmingsfout wordt gerapporteerd, gebruik dan in plaats daarvan de gefilterde opdracht voor de eerste keer uitvoeren.
corepack --version
corepack pnpm --version
# Windows PowerShell only, for Turbo commands:
$kitShimDir = Join-Path $env:LOCALAPPDATA 'supastack/corepack-shims'
New-Item -ItemType Directory -Path $kitShimDir -Force | Out-Null
corepack enable --install-directory $kitShimDir
$env:PATH = "$kitShimDir;$env:PATH"7. Ga verder met je platform
U bent klaar wanneer Node en Git versies afdrukken, Corepack de vastgezette pnpm kan selecteren en uw terminal in de map staat die package.json bevat. Kies hieronder één tutorial. Docker is optioneel voor de webdemonstratie; voor echte accounts is later een database vereist. Desktop heeft ook Rust en native buildtools nodig; die tutorial legt ze uit vóór het startcommando.