docs(windows): note Git Bash requirement for A2UI builds

aniruddhaadak80 · aniruddhaadak80 · commit a20702941c5e · 2026-03-12T22:03:26.000+05:30
diff --git a/docs/help/faq.md b/docs/help/faq.md
@@ -583,6 +583,12 @@ Two common Windows issues:
 - Add that directory to your user PATH (no `\bin` suffix needed on Windows; on most systems it is `%AppData%\npm`).
 - Close and reopen PowerShell after updating PATH.
 
+**3) `pnpm build` fails around `canvas:a2ui:bundle` / `bash`**
+
+- The from-source build bundles A2UI through a Bash script.
+- Install **Git for Windows** so Git Bash is available, then reopen PowerShell and rerun the build.
+- If you prefer to avoid native Windows shell differences entirely, use **WSL2** for repo builds.
+
 If you want the smoothest Windows setup, use **WSL2** instead of native Windows.
 Docs: [Windows](/platforms/windows).
 
diff --git a/docs/start/setup.md b/docs/start/setup.md
@@ -27,6 +27,12 @@ Last updated: 2026-01-01
 - `pnpm`
 - Docker (optional; only for containerized setup/e2e — see [Docker](/install/docker))
 
+Native Windows note:
+
+- The repo build runs `pnpm canvas:a2ui:bundle`, which invokes a Bash script for the A2UI host bundle.
+- If you build from native Windows instead of WSL2, install **Git for Windows** so Git Bash is available before running `pnpm build` or `pnpm build:strict-smoke`.
+- WSL2 remains the recommended Windows path for the full Gateway/tooling stack.
+
 ## Tailoring strategy (so updates don’t hurt)
 
 If you want “100% tailored to me” _and_ easy updates, keep your customization in:
