From 0808a3b024cbae69694cc9a032e816c129454382 Mon Sep 17 00:00:00 2001 From: david Date: Fri, 27 Feb 2026 15:42:13 -0700 Subject: [PATCH] docs: add Windows troubleshooting notes Signed-off-by: david --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.md b/README.md index 59a3694..f1cd695 100644 --- a/README.md +++ b/README.md @@ -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