Guide
Run your app in an emulator
Use the free desktop app to run your app on an emulator or your own phone.
Before you start
- A computer running Windows, macOS or Linux
- A Flutter project for the live stream
- 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
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
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
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
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
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.