diff --git a/README.md b/README.md
index 6457fd8..5b9cf5f 100644
--- a/README.md
+++ b/README.md
@@ -37,6 +37,15 @@ Once you have the IDs, Keys, and Secrets create an environment.go file based on
 ### Install Wails and Dependencies
 Please follow the instructions [here](https://v3.wails.io/getting-started/your-first-app/) to get Wails v3 up and running and follow the instructions below.
 
+System packages for building (the WebKitGTK 6 runtime above, plus
+compilers and headers) — Arch: `sudo pacman -S base-devel gtk4 webkitgtk-6.0 go nodejs npm` ·
+Debian/Ubuntu: `sudo apt install build-essential pkg-config libgtk-4-dev libwebkitgtk-6.0-dev golang nodejs npm`,
+then install the pinned CLI with `go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-beta.20`.
+
+> **Versioning note:** `1.99.x` is the v3-migration beta series — Wails v3
+> underneath, Svelte 4/Vite 4 toolchain refresh still pending. `2.0.0` is
+> reserved for the finished article. See `docs/V3_MIGRATION.md`.
+
 ## Live Development
 
 To run in live development mode, run `make dev` in the project directory (it runs `wails3 dev`). This starts a Vite development