# Documentation

## Pages

- [Introduction](/docs.md): Limrun is cloud infrastructure for mobile development. Run iOS simulators, Android emulators, and Xcode builds in the cloud, controlled through one CLI or SDK.
- [CLI for coding agents](/docs/agents/cli.md): Install the `lim` CLI in your coding agent's environment. The agent then builds your iOS app on a remote Mac, drives the simulator, and posts preview links on PRs.
- [MCP for controlling instances](/docs/agents/mcp.md): Every Limrun instance comes with its own MCP server. Wire it into a coding agent for tight device-control loops without shelling out to the CLI.
- [Run an Android Emulator](/docs/android/run-emulator.md): Spin up a cloud Android emulator. Install APKs, connect with ADB or control it with LIM SDK.
- [Build with remote Xcode](/docs/ios/build-with-xcode.md): Sync your source, run `xcodebuild` in the cloud, stream the logs back, and install the result on a remote simulator. Or ship a signed IPA.
- [Test In-App Purchases](/docs/ios/in-app-purchases.md): Test in-app purchases on a remote iOS simulator using StoreKit's local test environment. Register a `.storekit` config, or let Limrun snapshot one from your App Store Connect sandbox products.
- [Automatic PR Previews with GitHub Actions](/docs/ios/pr-previews.md): On every pull request, build the iOS app on Limrun, upload it to Asset Storage, and post a live preview link as a PR comment.
- [Run an iOS Simulator](/docs/ios/run-simulator.md): Drive a running iOS simulator from code or shell: taps, typing, screenshots, recordings, app lifecycle, logs, and reverse tunnels.
- [Asset Storage](/docs/platform/asset-storage.md): Limrun's managed binary store. Pre-install your customers' apps at instance boot and hot-deploy new builds into running embedded sessions
- [Embed the simulator](/docs/platform/embed-simulator.md): Render a live iOS, iPadOS, watchOS, or Android device inside your web app with `<RemoteControl />` from `@limrun/ui`. Your backend keeps the API key; the browser only sees a per-instance URL and token.
- [Quickstart](/docs/quickstart.md): Get a remote iOS simulator and Xcode build running from your terminal in 3 minutes.
- [SDK reference](/docs/reference.md): Authentication, errors, resource lifecycles, and the resources × CRUD matrix in cURL, TypeScript, Python, Go, and the `lim` CLI.
- [Appium](/docs/testing/appium.md): Drive Limrun iOS simulators and Android emulators with Appium. iOS uses a fork of the XCUITest driver; Android uses upstream Appium over an ADB tunnel.
- [Playwright](/docs/testing/playwright.md): Drive Chrome on a Limrun Android emulator with Playwright. The CDP WebSocket terminates on the emulator's host, so tests stay responsive across regions.