Troubleshooting

Aimed at contributors and self-hosters. The hosted webapp has no setup you can break.

Wrong Node.js version

nvm use

Picks up the version pinned in .nvmrc.

Escalate in this order — only go further if the previous step doesn't fix it:

Reinstall from the existing lockfile (safe — preserves the version graph everyone else uses):
```
pnpm install --frozen-lockfile
```

Wipe node_modules and reinstall (still safe, lockfile preserved):

rm -rf node_modules **/node_modules
pnpm install --frozen-lockfile

Last resort — regenerate the lockfile (changes dependencies; commit the result for review):
```
rm -rf node_modules **/node_modules pnpm-lock.yaml
pnpm install
```

Run all of the above from the monorepo root so pnpm workspaces resolve correctly.

pnpm dev resolves port collisions automatically. For direct docker compose commands, stop whatever is holding the port and retry:

docker compose -f ./docker/compose.local.yml down
docker compose -f ./docker/compose.local.yml up --build

Install Xcode (iOS) or Android Studio (Android), then re-sync:

pnpm build
pnpm capacitor:sync