# BrowserStack

AppfigurateSE can pre-package the iOS physical device builds with your local database of app metadata records and then upload the resulting binary to BrowserStack. You can then use Appfigurate to configure your own app in BrowserStack App Live.

## Corporate proxy

If you are behind a corporate proxy, then tap the Proxy icon in the toolbar:

<figure><img src="/files/CiF8T58Uj36nHFzKayys" alt="" width="563"><figcaption><p>AppfiguateSE Proxy icon in the toolbar</p></figcaption></figure>

The proxy settings page will be displayed:

<figure><img src="/files/EBow4BSricZ8oyQdu78k" alt=""><figcaption><p>AppfigurateSE proxy settings page</p></figcaption></figure>

AppfigurateSE currently supports HTTP proxies without authentication. The proxy host and proxy port will be saved into user defaults.

## Sign in to BrowserStack

Your BrowserStack Username and Access Key can be found in BrowserStack under Account & Profile ‣ Details ‣ Authentication & Security.

<figure><img src="/files/4UOzvVG31haECcZpYva0" alt=""><figcaption><p>AppfigurateSE BrowserStack sign in page</p></figcaption></figure>

Tick on `Save credentials` to save your Username and Access Key into the Keychain. Your credentials will be automatically populated the next time you use AppfigurateSE.

If sign in is successful, the following screen is displayed. The left hand pane shows any previously uploaded Appfigurate iOS. The right hand pane displays the local database of app metadata records.&#x20;

If your local database is empty the local database of app metadata records is shared by Appfigurate Simulator app for all iOS Simulators.

<figure><img src="/files/GNCkK5VUKEwxU6Mgpfo6" alt=""><figcaption><p>AppfigurateSE upload to BrowserStack page</p></figcaption></figure>

## Uploading an Appfiguate app

Tap the `Upload Appfigurate iOS` button to pre-package the iOS physical device build with the local database's app metadata records. It can take several minutes to generate the app and upload it to BrowserStack (depending on the speed of your internet connection) .

{% hint style="info" %}
All app metadata records in the local database will be available in BrowserStack. Please read [Security Best practice](/additional-reading/security/best-practice.md#real-device-cloud-testing-services).
{% endhint %}

## Deleting an Appfigurate app

Swiping from right to left over any previously uploaded Appfigurate app will display a delete icon. Tapping the delete icon will delete the iOS Appfigurate pre-packaged app from BrowserStack.

<div align="center"><figure><img src="/files/KlQppEr0Dju60SvptYBF" alt="" width="320"><figcaption></figcaption></figure></div>

You can also delete a previously uploaded app in BrowserStack.

## BrowserStack uploaded apps

Uploaded pre-packaged Appfigurate apps appear in the Uploaded apps dialog in BrowserStack:

<figure><img src="/files/BbToxB93ge9JMikeTii6" alt="" width="307"><figcaption></figcaption></figure>

## Installing Appfigurate when testing your own app

When testing your own app in BrowserStack on a real device, to install Appfigurate into the same device, tap the Install New App link in the left hand menu:&#x20;

<figure><img src="/files/wDAMbMLqJtkVbdV8v5IX" alt="" width="151"><figcaption></figcaption></figure>

## Pre-packaged Appfigurate app restrictions

When the Appfigurate iOS physical device builds detect they have been pre-packaged with app metadata records and running in a real device cloud testing service, then only the [Select app](/appfigurate-user-guide/select-app.md), [Edit app](/appfigurate-user-guide/edit-app.md) and [Configure app](/appfigurate-user-guide/configure-app.md) screens are available. All other screens and features are automatically disabled including [Add app](/appfigurate-user-guide/add-app.md), [Import app](/appfigurate-user-guide/import-app.md), [Install example apps](/appfigurate-user-guide/install-example-apps.md) and  [Settings](/appfigurate-user-guide/settings.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.electricbolt.co.nz/appfigurate-se-user-guide/real-device-cloud-testing-services/browserstack.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
