1 files changed, 29 insertions, 0 deletions
diff --git a/doc/BUILD.md b/doc/BUILD.md
new file mode 100644
index 0000000..3a581b1
--- /dev/null
+++ b/doc/BUILD.md
@@ -0,0 +1,29 @@
+# Build Instructions
+
+Debug build:
+cmake -S . -B build
+cmake --build build
+
+Size-optimized build:
+cmake -S . -B build -DDEMO_SIZE_OPT=ON
+cmake --build build
+
+## Windows Cross-Compilation (from macOS)
+
+Requires `mingw-w64` and `wine-stable` (for testing).
+
+1. Fetch Windows binaries:
+   ```bash
+   ./scripts/fetch_win_deps.sh
+   ```
+
+2. Build for Windows:
+   ```bash
+   ./scripts/build_win.sh
+   ```
+   This will produce `build_win/demo64k_packed.exe`.
+
+3. Run with Wine:
+   ```bash
+   ./scripts/run_win.sh
+   ```