> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# Platform environment setup

Each platform guide prepares one environment: the connection tools, device connection, and system permissions that Midscene needs. Playground, Midscene Test, and the JavaScript SDK all use the same environment. Each guide ends with a Verify section that checks the environment in Playground.

Midscene uses multimodal vision models to understand screenshots, operating directly on the rendered UI rather than relying on the underlying DOM or native view hierarchy. This allows the same interaction and assertion approach to work across native apps and cross-platform frameworks alike.

## Choose a platform

| Platform                             | npm package          | Connection method                                                       | Typical use cases                                          |
| ------------------------------------ | -------------------- | ----------------------------------------------------------------------- | ---------------------------------------------------------- |
| [Web](/platforms/web.md)             | `@midscene/web`      | Chrome extension (Playground); Playwright / Puppeteer (SDK integration) | Web testing and browser automation                         |
| [Chrome Bridge](/bridge-mode.md)     | `@midscene/web`      | Chrome extension                                                        | Reusing existing login sessions and tabs in desktop Chrome |
| [Android](/platforms/android.md)     | `@midscene/android`  | `adb`                                                                   | Android apps and system UI automation                      |
| [iOS](/platforms/ios.md)             | `@midscene/ios`      | WebDriverAgent                                                          | iOS apps and system UI automation                          |
| [HarmonyOS](/platforms/harmonyos.md) | `@midscene/harmony`  | HDC                                                                     | HarmonyOS NEXT apps and system UI automation               |
| [Desktop](/platforms/desktop.md)     | `@midscene/computer` | Native mouse/keyboard or RDP                                            | Windows, macOS, and Linux desktop application automation   |