Join our Discord
Connect your app
Upload an iOS or Android build, or pick one already on BrowserStack, then start a real-device session in Test Companion.
Test Companion needs an app file before it can generate, automate, or fix anything. After you connect, the AI runs your app on a real BrowserStack device for every task in the session.
Switch to App mode
Test Companion opens in Web mode. Click App at the bottom of the panel to switch.
A Select App button appears next to the toggle.
Quick-action buttons (Generate test cases, Write automation code, and others) work the same way in both modes. The difference is what they run against. Web mode runs on a URL. App mode runs on your connected app.
Connect an app file
Click Select App to open the Connect the App to test dialog. You have two options.
Option 1: Upload a new build
Click Browse file and select a file from your computer.
| File type | Platform | Description |
|---|---|---|
.apk |
Android | Standard Android application package. |
.aab |
Android | Android App Bundle, Google’s publishing format. |
.xapk |
Android | Extended APK that includes additional resources. |
.ipa |
iOS | Standard iOS application archive. |
The build is stored in your BrowserStack account. You do not need to upload it again unless you have a new version.
Option 2: Select a previously uploaded app
Below the upload area, the Recently Uploaded Apps on BrowserStack section lists every build in your account, including builds uploaded through App Automate.
Each entry shows the file name, version, who uploaded it, and when. The platform icon shows whether it’s an Android .apk or an iOS .ipa.
To find an app in a long list, type in the search bar or click Filters to narrow by platform or upload date.
Click any app to select it.
Verify the app is connected
After you select or upload an app:
- The dialog closes and you return to the Test Companion panel.
- The selected app appears as a chip next to the App toggle (for example,
LocalSample.ip... ×).
The chip is your confirmation. The next prompt you send starts a real-device session, installs the app, and runs the requested task.
Switch or disconnect the app
To switch apps, click × on the app chip, then click Select App to pick a different one.
To return to web testing, click the Web toggle. Your app selection and workspace context are preserved. The connection survives across mode switches and workspace restarts.
Connect apps for a multi-device flow
Some flows run across two or more devices at the same time. An action on one device produces a result that you verify on another. A chat message sent from one account and read on another is one example. You can connect up to four apps for one flow.
To connect more than one app:
- In App mode, click Select App.
- In the Connect the App to test dialog, click the Multi App tab. The dialog opens on the Single App tab by default.
- Select the first app. It appears as a numbered chip, and the dialog title changes to Select App 2.
- Select each remaining app. To remove an app, click the remove option on its chip.
- Click Proceed with N apps. The button appears after you select at least two apps.
The Select App button in the chat box changes to N apps, where N is the number of connected apps. Click it to view every connected app or to add another one.
The same dialog applies whether you generate test cases or automation scripts. Describe the flow across the devices in your prompt. Test Companion starts a real-device session for each connected app and works through the flow you describe.
For multi-device example prompts, see Generate test cases across multiple devices and Automate a multi-device flow.
Next steps
- Generate test cases: Create test cases from requirements or by exploring the app.
- Automate tests: Generate executable scripts for any framework.
- Fix failed tests: Diagnose and patch failing app tests.
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
Thank you for your valuable feedback!