Skip to content

armgit / mimik

Public Imported from GitHub
0

🎬 A browser extension and desktop app that turns your clicks into step-by-step guides with annotated screenshots πŸ“–

docs: describe testing on Windows

Luis Ortiz2dd7689f69e7
diff --git a/AGENTS.md b/AGENTS.md
index 4a8b2a7..fd5a926 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -381,6 +381,33 @@ opt-in rule holds in three positions, a 400 ms delay measurably slows the grab,
synthetic frame encodes to a different size once a cursor is drawn into it. It restores whatever
settings were on disk when it finishes.
+## Testing on Windows
+
+`pnpm vm:windows` runs the desktop app inside a local Windows virtual machine, because the app cannot
+be built for Windows from a Linux machine at all. `get-windows` and `uiohook-napi` are native, no
+win32 binary matches the Electron ABI during a cross-build, and `node-gyp` refuses to cross-compile,
+so `electron-builder --win` fails before it packages anything. Windows has to build its own copy.
+
+The script creates the machine on first run through `quickemu`, fetches the VirtIO drivers, stages the
+current commit with `git archive`, serves it on loopback and boots. QEMU user-mode networking always
+maps the host to `10.0.2.2`, so the guest pulls the source over plain HTTP and needs no shared folder,
+no samba and no SPICE webdav. Inside Windows one line installs Node and pnpm through `winget`,
+unpacks the source to `C:\mimik`, installs and launches. Iterating is: change code, re-run the
+script, re-run the same line in the guest.
+
+Four steps cannot be scripted and the script says so rather than failing quietly:
+
+- Microsoft blocks automated ISO downloads by IP, so the Windows image is fetched once by hand
+- PowerShell refuses unsigned scripts, so the bootstrap runs through `-ExecutionPolicy Bypass`
+- Windows remembers its own display mode, so `--width` and `--height` do not stick and the resolution
+ is set once inside the guest
+- `quickget` leaves a truncated VirtIO download that curl cannot resume, so the script refetches it
+ whenever the file is implausibly small
+
+Whether `uiohook-napi` ships a prebuilt binary for this Electron version on Windows is still unknown.
+The first machine had the Visual Studio Build Tools installed before `pnpm install` ran, so it may
+have compiled rather than downloaded. A fresh machine without them settles it.
+
## Export Formats
| Format | Generator | Details |