docs: add Windows troubleshooting notes

Signed-off-by: david <openonimpact@gmail.com>
This commit is contained in:
david 2026-02-27 15:42:13 -07:00
parent b57faa2c59
commit 0808a3b024
1 changed files with 10 additions and 0 deletions

View File

@ -33,6 +33,16 @@ Before getting started, you'll want to install:
- Node.js
- pnpm (run `corepack enable`)
### Windows notes
If `pnpm` fails in PowerShell with `running scripts is disabled` (pnpm.ps1):
- Run: `Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned`
- Close and reopen Powershell, then try `pnpm` again.
If native modules fail to build (node-gyp errors, missing `cl` or `msbuild`):
- Install "Build Tools for Visual Studio 2022" with "Desktop development with C++" (MSVC v143 and Windows SDK).
- Run commands from "x64 Native Tools Command Prompt for VS 2022" (or "Developer Powershell for VS 2022") so `cl.exe` and `msbuild.exe` are on PATH.
Then proceed to setup:
```bash