From 36f1d44e5c9ea5e7dd37783cd41ac27b1d12ab77 Mon Sep 17 00:00:00 2001
From: matt wilkie <maphew@gmail.com>
Date: Mon, 13 Oct 2025 20:30:59 -0700
Subject: [PATCH] Windows build instructions (tested)

---
 README.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/README.md b/README.md
index a0756033..2ec289d3 100644
--- a/README.md
+++ b/README.md
@@ -71,6 +71,25 @@ go build -o bd ./cmd/bd
 sudo mv bd /usr/local/bin/  # or anywhere in your PATH
 ```
 
+#### Windows 11
+For Windows you must build from source.
+Assumes git, go-lang and mingw-64 installed and in path.
+
+```pwsh
+git clone https://github.com/steveyegge/beads
+cd beads
+$env:CGO_ENABLED=1
+go build -o bd.exe ./cmd/bd
+mv bd.exe $env:USERPROFILE/.local/bin/ # or anywhere in your PATH
+```
+
+Tested with mingw64 from https://github.com/niXman/mingw-builds-binaries
+- version: `1.5.20`
+- architecture: `64 bit`
+- thread model: `posix`
+- C runtime: `ucrt`
+
+
 ## Quick Start
 
 ### For Humans