4 files changed, 80 insertions, 9 deletions

diff --git a/docs/GUI-PLAN.md b/docs/GUI-PLAN.md
index 2789b81..8c3db0a 100644
--- a/docs/GUI-PLAN.md
+++ b/docs/GUI-PLAN.md
@@ -69,16 +69,43 @@ crash board from its local clock.
 
 ## Phase 3 — `gui/` skeleton and the style spike
 
-- Add the `gui/` workspace member (eframe), no game code yet.
-- Theme module with the agreed tokens, two fonts, spacing scale.
-- One reference screen: the roulette felt with chips, cursor, and a spinning
-  number, plus the persistent header (connection, balance, account).
-- Verify the Windows cross-compile with a hello-world before going further.
-
-**Gate:** your approval of the screenshot at 1080p; binary ≤ 40 MB, idle
-≤ 150 MB, cold start ≤ 1 s, 60 fps on integrated graphics.
+**Code complete in v4.1.0; awaiting the screenshot sign-off.**
+
+- `gui/` is a workspace member (`zagan-bet-gui`). It depends on the core with
+  `default-features = false`, so neither egui nor native-tls enters the TUI or
+  server build graph. The build uses the workspace's `gui-release` profile
+  (opt-level `z`, LTO, stripped).
+- `gui/src/theme.rs` holds the tokens: the terminal-derived dark palette, felt
+  green kept for the table, a 4/8/12/16/24 spacing scale, radii, and the type
+  scale. Two embedded fonts: Open Sans (OFL) for text, Hack (MIT) for numbers,
+  chips and labels. Licences sit next to the files in `gui/assets/fonts/`.
+- `gui/src/roulette.rs` draws the felt, chips, the fine lattice cursor and the
+  wheel from a `RouletteView`; it owns the geometry, not the rules.
+- `gui/src/app.rs` composes the persistent header (connection, account,
+  balance) with the table and the betting sidebar. The demo state animates a
+  2.4 s wheel spin and highlights the winning pocket and cell.
+- `gui/tests/layout.rs` covers the pure maths (money grouping, wheel angle,
+  table aspect, bet names). UI wiring tests arrive with `egui_kittest` in
+  Phase 4.
+
+Measured on Linux at 1080p with llvmpipe software GL:
+
+| Check | Result |
+| --- | --- |
+| Linux binary | 6.0 MB |
+| Windows x86_64 binary | 4.7 MB |
+| Cold start to window | 52 ms |
+| Idle RSS | 137 MB |
+| Idle CPU | 0% |
+
+The approved reference lives at `docs/screenshots/gui-roulette-1080p.png`, with
+the result state at `docs/screenshots/gui-roulette-result-1080p.png`.
+
+**Gate:** the screenshot needs your approval. Frame rate on integrated graphics
+still needs a run on real hardware.
 
 ## Phase 4 — GUI wiring
+## Phase 4 — GUI wiring
 
 - Network thread with channels, request deadlines in the shared adapter.
 - Trust modal, version-mismatch screen, login/register, lobby, history panel.
diff --git a/docs/TESTING.md b/docs/TESTING.md
index 23e3a19..f42b84a 100644
--- a/docs/TESTING.md
+++ b/docs/TESTING.md
@@ -3,7 +3,7 @@
 ## Automated suite
 
 ```sh
-cargo test
+cargo test --workspace
 ```
 
 The suite is deterministic and headless: no network, no PTY, no sleeps, no
@@ -46,10 +46,14 @@ or a vendored OpenSSL.
 | `tests/slots.rs` | Server slots payout rules and overflow handling. |
 | `tests/storage.rs` | Client/server SQLite storage helpers. |
 | `tests/tofu.rs` | SPKI fingerprint and TOFU decisions. |
+| `gui/tests/layout.rs` | GUI presentation maths: money grouping, wheel angle, table aspect, bet names. |
 
 `tests/tofu.rs` and `tests/server_setup.rs` shell out to `openssl`, so run them
 on a machine where the `openssl` CLI is available.
 
+The GUI has its own integration tests because the root package cannot depend on
+the GUI (`gui/tests/`); `cargo test --workspace` runs both halves.
+
 ## Development resets
 
 The server creates `server.db` in its working directory. The client keeps
@@ -67,6 +71,21 @@ rm -rf ~/.local/share/zagan-bet
 The audit schema is not auto-migrated from the pre-2.0 slots-only `plays`
 table. Starting against an old database will fail until it is removed.
 
+## Building the GUI
+
+The GUI is a workspace member, so it never enters the TUI or server build graph:
+
+```sh
+cargo build -p zagan-bet-gui                                  # debug
+cargo build -p zagan-bet-gui --profile gui-release            # release
+cargo build -p zagan-bet-gui --target x86_64-pc-windows-gnu \
+  --profile gui-release                                       # Windows
+```
+
+`gui-release` is declared at the workspace root; a profile inside a member's
+manifest would be ignored. Fonts are embedded, so there is no runtime asset
+directory to ship.
+
 ## Manual TUI checklist
 
 There is no CI. Run this on Linux and on a Windows VM before a release.
@@ -97,6 +116,31 @@ Use an 80-column terminal because several output lines are width-sensitive.
     under a single fingerprint, because the certificate key is the same.
 11. Windows: repeat 2-10 and confirm keys are not duplicated or printed twice.
 
+## Manual GUI checklist
+
+The GUI is a style spike until Phase 4: the table and wheel are painted from a
+demo `RouletteView`, and no network connection is made. Run it on Linux and on
+Windows 10 before approving the look.
+
+1. `cargo run -p zagan-bet-gui` at 1440x900, then at 1920x1080. The header
+   keeps its right margin at both sizes and shows ONLINE, host, ping, account
+   and balance; the table is centred and the sidebar is full height.
+2. The felt shows 0, the 3x12 numbers, dozens, columns and the six outside
+   cells. Chips sit on their targets: a straight in the cell, a corner on the
+   lattice crossing, an outside bet in its box.
+3. Click a pocket: a chip of the selected denomination appears and the slip
+   gains a row. Chips are 10/25/50/100; the selected one has a cyan ring.
+4. Arrow keys move the cursor. Over the numbers the cyan marker sits on the
+   cell or lattice point and the covered cells tint; leaving the table walks
+   dozens, columns and outside.
+5. Space or SPIN animates the wheel for about 2.4 s and stops with the winning
+   pocket under the pointer. The winning cell gets a gold outline, RESULT names
+   the number and colour, and LAST gains a dot. SPIN is disabled during the
+   spin.
+6. Clear bets empties the slip and the total. Resize to 1100x720: the sidebar
+   scrolls, nothing overlaps the header, and the table keeps its aspect ratio.
+7. Compare the 1080p window against the approved reference screenshot.
+
 ## Manual roulette checklist
 
 1. `play roulette` draws the full felt: 0, the 3x12 numbers, dozens, columns,
diff --git a/docs/screenshots/gui-roulette-1080p.png b/docs/screenshots/gui-roulette-1080p.png
new file mode 100644
index 0000000..b6c9b17
--- /dev/null
+++ b/docs/screenshots/gui-roulette-1080p.png
diff --git a/docs/screenshots/gui-roulette-result-1080p.png b/docs/screenshots/gui-roulette-result-1080p.png
new file mode 100644
index 0000000..0f37133
--- /dev/null
+++ b/docs/screenshots/gui-roulette-result-1080p.png