ProbablyMonsters logo ProbablyMonsters Workspace onboarding
New developer setup

Set up your workspace

The workspace is a container image with all shared tooling baked in. On Windows it runs as a WSL distro — your host just runs it. Follow the steps below.

~10 minutes Windows + WSL2 6 steps

  1. Open PowerShell as Administrator

    Right-click the Start menu → Terminal (Admin) or Windows PowerShell (Admin). The WSL2 install fails without it.

  2. Generate a token

    Create a personal access token (scopes repo, read:packages), then click Configure SSO and authorize the ProbablyMonsters org.

  3. Set your token powershell

    Replace the placeholder with the token you just generated:

    powershell
    $env:GITHUB_TOKEN = "<PASTE-YOUR-TOKEN-HERE>"

  4. Run the bootstrap powershell

    powershell
    iwr -UseBasicParsing -Headers @{Authorization="token $env:GITHUB_TOKEN"} `
  https://raw.githubusercontent.com/ProbablyMonsters/platform-env/main/packages/host-bootstrap/bootstrap.ps1 | iex

    Installs WSL2 if needed, downloads the workspace image, imports it as a pm-workspace distro, and persists your token inside.

  5. Enter the workspace powershell

    powershell
    wsl -d pm-workspace

  6. Clone & init the repos WSL

    pm-workspace
    clone-repos

    Clones platform-env, platform-infra, nakama-service, pm-nakama-modules and runs bun run init in each. Pass names to clone a subset.

Onboarding — Linux / macOS (aspirational, untested)
bash
export GITHUB_TOKEN="<PASTE-YOUR-TOKEN-HERE>"
curl -fsSL -H "Authorization: token $GITHUB_TOKEN" \
  https://raw.githubusercontent.com/ProbablyMonsters/platform-env/main/packages/host-bootstrap/bootstrap.sh | bash