Skip to main content

Guide

Run your app in an emulator

Use the free desktop app to run your app on an emulator or your own phone.

About 10 min6 steps

Before you start

  • A computer running Windows, macOS or Linux
  • A Flutter project for the live stream
  1. 1

    Install the desktop app

    Download the AppMuse Companion from appmuse.dev/companion and log in with the same account you use in the browser. The two find each other through your account, so nothing needs to be configured.

  2. 2

    Let the setup wizard do its thing

    The first time you run the Companion it checks whether the Android tools are installed and offers to set up what is missing. Follow the prompts. This is a one-time step.

  3. 3

    Start an emulator or plug in a phone

    The Companion detects Android emulators on your computer and can create one if you have none. You can also plug in a real phone over USB: Android phones work on Windows and Mac, iPhones on Mac. For a USB phone, enable USB debugging in the phone's developer settings.

  4. 4

    Open Live Preview in your project

    Back in the browser, open the Live Preview in your project and pick the device. Your app starts on the emulator or phone and the screen streams into the browser. You can tap and swipe right in the browser window.

  5. 5

    Watch changes appear by themselves

    When the AI changes your app, the running app reloads with the change. You keep chatting on one side and watch the app update on the other.

  6. 6

    Or build inside the desktop app

    Each project in the desktop app has a Companion / Workspace switch. Workspace mode gives you the chat, your files and a local preview in one window, with no video stream, since the emulator runs on the same computer.

If something goes wrong

The browser does not find the Companion

Make sure the Companion app is running and that you are logged in with the same account in both places.

The emulator is very slow to start

The first boot of a new emulator can take a few minutes. Leave it running. Later starts are much faster.

A USB phone does not show up

Enable Developer options and USB debugging on the phone, then reconnect the cable and accept the prompt on the phone screen.

Keep going