From ad8d4f36d915be60583e68a06eb28824b7f4a922 Mon Sep 17 00:00:00 2001
From: Zach Russell <zachatrocity@gmail.com>
Date: Mon, 13 Apr 2026 21:44:25 -0600
Subject: [PATCH] Update windows build chain docs

---
 README.md | 34 ++++++++++++++++++++++++++++++++--
 1 file changed, 32 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 0fe2a1b..890c11a 100644
--- a/README.md
+++ b/README.md
@@ -156,9 +156,39 @@ Or, try the Nix package: `nix run git+https://git.federated.nexus/Henry-Hiles/ne
 - With Nix: Either use direnv and `direnv allow`, or `nix flake develop`
 - Without Nix: Install Flutter, Go, Git, Libclang, and Glibc. Do not use any Snap packages, they cause various compilation issues.
 
-#### Windows / MacOS
+#### Windows
 
-I don't really know. You will need Flutter, Git, Go, and Visual Studio tools, and otherwise I guess just keep installing stuff until there aren't any errors. I will look into this sometimeTM.
+You will need:
+
+- Flutter
+- Android SDK + NDK
+- Git
+- Go
+- Visual Studio 2022 (Desktop development with C++)
+- [MSYS2/MinGW-w64 GCC](https://www.msys2.org/) (for CGO)
+- [LLVM/Clang + libclang](https://clang.llvm.org/get_started.html) (for `ffigen`)
+
+On Windows, make sure these are available in your shell `PATH`:
+
+- `C:\msys64\ucrt64\bin` (or your MinGW bin path containing `x86_64-w64-mingw32-gcc.exe`)
+- `C:\Program Files\LLVM\bin` (contains `clang.exe` and `libclang.dll`)
+
+Also make sure Go build cache env vars are present (PowerShell):
+
+```powershell
+$env:LOCALAPPDATA = "C:\Users\<you>\AppData\Local"
+$env:GOCACHE = "$env:LOCALAPPDATA\go-build"
+```
+
+For `dart scripts/generate.dart`, you may also need:
+
+```powershell
+$env:CPATH = "C:\msys64\ucrt64\include"
+```
+
+#### MacOS
+
+Similar prerequisites apply (Flutter, Git, Go, C toolchain, LLVM/libclang), but exact setup has not been fully documented yet.
 
 ### Clone repo
 
-- 
2.53.0