# Platform Notes

ZoneGaze Flow has a shared product workflow across platforms, with different launch and runtime details.

## Web Control Surface

The web control surface is the main task board. It is where you create work, start agents, monitor execution, inspect review state, and archive completed tasks.

![Web board overview](./assets/screenshots/web-board-overview.png)

## Mac

The Mac app starts or attaches to the local runtime and opens the Matrix dashboard directly.

![Mac Matrix dashboard](./assets/screenshots/mac-desktop-dashboard-current.png)

If the local runtime stops or becomes unreachable, the Mac app shows the recovery screen.

![Mac disconnected runtime recovery](./assets/screenshots/mac-desktop-disconnected-current.png)

[Watch the Mac Matrix launch clip](./assets/videos/mac-matrix-dashboard-launch.webm)

<video controls src="./assets/videos/mac-matrix-dashboard-launch.webm" title="Mac Matrix dashboard launch"></video>

Use the Mac app when you want a desktop control surface for a local development machine.

## Android

The Android app provides a native Matrix dashboard and uses the app-owned Zone Terminal backend for local runtime setup.

![Android home dashboard](./assets/screenshots/android-home-dashboard.png)

The setup dashboard checks:

- whether the owned Zone Terminal runtime package is ready
- whether automatic setup has completed
- whether the selected plugin needs a runtime, endpoint, or native surface
- whether the bundled runtime is ready
- whether the selected launch folder is saved

Native Android setup screens:

![Android permissions dashboard](./assets/screenshots/android-permissions-dashboard.png)

![Android runtime dashboard](./assets/screenshots/android-setup-dashboard.png)

![Android ports dashboard](./assets/screenshots/android-ports-dashboard.png)

[Watch the Android install and launch workflow](../assets/videos/zonegaze-flow-android-install-launch-current.mp4)

<video controls src="../assets/videos/zonegaze-flow-android-install-launch-current.mp4" title="Android Matrix install and launch workflow"></video>

Fresh shell-navigation clip from the current emulator run:

[Watch the live Android shell navigation clip](./assets/videos/android-matrix-live-shell-navigation.mp4)

<video controls src="./assets/videos/android-matrix-live-shell-navigation.mp4" title="Android Matrix shell navigation"></video>

After setup completes, the Home tab shows the next-step state and the embedded WebView board can
open inside the app.

![Android WebView board](./assets/screenshots/android-webview-board.png)

## CLI

The CLI path is best for package users, contributors, and automation environments.

```bash
npx zonegaze-flow
```

Use the CLI when you need direct terminal control or when you are running ZoneGaze Flow without the Mac or Android shell.

## Choosing A Platform

- Use Mac for normal desktop development.
- Use Android for mobile/local-device workflows after owned Zone Terminal setup is complete.
- Use CLI for automation, package testing, and contributor workflows.
- Use the web control surface for day-to-day task coordination on every platform.
