# Platform Application Guides

These guides are for users who install ZoneGaze Matrix as an application instead of launching the
Flow CLI/runtime from an npm command or a checked-out repository.

## Choose A Launch Path

| User type | Recommended path | Needs repo checkout? | Needs terminal command? |
| --- | --- | --- | --- |
| Mac desktop user | [Direct Mac application](direct-mac-application.md) | No | No |
| Android user | [Direct Android application](android-application.md) | No | No |
| CLI user | [CLI reference](../reference/cli.md) | No | Yes |
| Contributor | [Developer onboarding](../developer/onboarding.md) | Yes | Yes |

The command-line examples in developer docs are for package users, contributors, and local
verification. Normal desktop and Android users should start with the direct application guide for
their platform.

## Shared Runtime Features

After a direct app starts the local runtime, the same board, task, agent, review, Git, settings, worktree, MCP, terminal, and project-context features are available. The full feature surface is documented in [ZoneGaze Flow core features](../features/zonegaze-flow-core-features.md).

The Flow sidebar also exposes the Plugins section. It lists ZoneGaze Flow as the built-in product,
ZoneGaze Whispr and ZoneGaze Code as downloadable plugins, and Open Design as an upstream plugin.
Download and publishing still happen through the trusted ZoneGaze downloads hub; installed plugins
can be opened from Flow when a platform bridge supports detection. ZoneGaze Code is the
ZoneGaze-branded Code-OSS workspace IDE, with a Mac app target and Android Zone Terminal code-server adapter.

Screenshot: [open board input](../assets/screenshots/core-board-input.png)

![Board overview after direct app launch](../assets/screenshots/core-board-input.png)

## Platform Evidence

Current Mac installed app board screenshot: [open current Mac install/launch screenshot](../assets/screenshots/mac-install-launch-current.png)

![Current installed Mac app showing the ZoneGaze Flow board inside the Electron shell](../assets/screenshots/mac-install-launch-current.png)

Current Mac install/launch video: [open current Mac install/launch video](../assets/videos/zonegaze-flow-mac-install-launch-current.webm)

![Current ZoneGaze Flow Mac install and launch video](../assets/videos/zonegaze-flow-mac-install-launch-current.webm)

Mac full workflow video: [open Mac full workflow](../assets/videos/zonegaze-flow-mac-full-workflow.webm)

![ZoneGaze Flow Mac full workflow video](../assets/videos/zonegaze-flow-mac-full-workflow.webm)

Current Android emulator install screenshot: [open current Android install/launch screenshot](../assets/screenshots/android-install-launch-current.png)

![Current Android emulator showing the installed ZoneGaze Flow APK dashboard](../assets/screenshots/android-install-launch-current.png)

Current Android emulator install video: [open current Android install/launch video](../assets/videos/zonegaze-flow-android-install-launch-current.mp4)

![Current ZoneGaze Flow Android emulator install and launch video](../assets/videos/zonegaze-flow-android-install-launch-current.mp4)

Android dashboard setup recording: [open Android dashboard setup recording](../assets/videos/zonegaze-flow-android-dashboard-setup.mp4)

![ZoneGaze Flow Android dashboard setup video](../assets/videos/zonegaze-flow-android-dashboard-setup.mp4)

Fresh Android live shell capture set (`2026-07-09`): [dashboard](../assets/screenshots/android-emulator-dashboard.png), [plugins](../assets/screenshots/android-plugin-catalog-current.png), [runtime](../assets/screenshots/android-runtime-status-current.png), [ports](../assets/screenshots/android-ports-status-current.png), [WebView first open](../assets/screenshots/android-webview-first-open-current.png), and [shell navigation video](../assets/videos/zonegaze-flow-android-live-shell-navigation-current.mp4).

The current Android recording verifies APK install and native dashboard launch on the `ZoneGaze_Runtime_16` emulator. It is not proof of the full owned-runtime workflow; that remaining capture scope is tracked in [Direct Android application recording status](android-application.md#recording-status).

## Related Docs

- [Software manual](../manual/software-manual.md)
- [Feature catalog](../features/feature-catalog.md)
- [Feature coverage matrix](../features/feature-coverage-matrix.md)
- [Getting started](../user/getting-started.md)
- [Troubleshooting](../user/troubleshooting.md)
- [System design](../architecture/system-design.md)
- [Video assets](../assets/videos/README.md)
