# ZoneGaze Matrix Live Asset Refresh 001

This run captured fresh live documentation assets on `2026-07-09`.

## Goal

Refresh current documentation media from a live product run instead of relying only on older
promoted screenshots and videos.

## Environment

- Host: MacBook
- Android device target: Android 16 emulator `emulator-5554`
- Android package: `com.zonegaze.matrix`
- APK used: `platforms/android/app/build/outputs/apk/debug/app-debug.apk`
- Mac package attempted: `platforms/desktop/out/ZoneGaze Matrix-0.1.69-arm64.dmg`

## Successful Live Captures

Android native shell:

- `android-live-dashboard-raw.png`
- `android-dashboard-live.png`
- `android-plugins-live.png`
- `android-runtime-live.png`
- `android-ports-live.png`
- `android-live-tabs.mp4`

Android embedded board evidence:

- `android-runtime-running-attempt.png`
- `android-webview-open-attempt.png`
- `android-webview-board-clean.png`

Promoted stable docs assets:

- `docs/assets/screenshots/android-install-launch-current.png`
- `docs/assets/screenshots/android-emulator-dashboard.png`
- `docs/assets/screenshots/android-plugin-catalog-current.png`
- `docs/assets/screenshots/android-runtime-status-current.png`
- `docs/assets/screenshots/android-ports-status-current.png`
- `docs/assets/screenshots/android-webview-first-open-current.png`
- `docs/assets/videos/zonegaze-flow-android-live-shell-navigation-current.mp4`

Website-ready refreshed assets:

- `docs/website/assets/screenshots/android-home-dashboard.png`
- `docs/website/assets/screenshots/android-setup-dashboard.png`
- `docs/website/assets/screenshots/android-ports-dashboard.png`
- `docs/website/assets/screenshots/android-webview-board.png`
- `docs/website/assets/videos/android-matrix-live-shell-navigation.mp4`

## Mac Blockers

The Mac packaged-app refresh did not produce new stable UI assets in this run.

Observed blockers:

- macOS surfaced a Gatekeeper/XProtect dialog saying `ZoneGaze Matrix` was not opened because it
  "contains malware"
- launching the app bundle binary directly kept a process alive but produced no visible Electron
  window
- `npm --prefix platforms/desktop run dev` failed before a usable window opened with
  `ERR_MODULE_NOT_FOUND` for `flow/kanban-core/src/task-title.js` imported from
  `flow/contracts/src/api-contract.ts`

Because of that, earlier promoted Mac screenshots and videos were kept instead of being replaced
with misleading or partial artifacts.

## Notes

- The Android WebView screenshots prove the board opens inside Matrix, but the first-open onboarding
  overlay is still visible in the captured state.
- The short runtime-to-board recording attempt was not durable enough to promote as a stable video,
  so only the shell-navigation recording was promoted this run.
