# Select app

Starting Appfigurate for the first time, or when you have no app metadata records in your local database will result in the following screen.

<div align="left"><figure><img src="https://1008176080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw1fcw3dvtSrfUh3YtO9Z%2Fuploads%2FpsY2r0yxQYT598iqt9y0%2FSimulator%20Screenshot%20-%20iPhone%20SE%20(2nd%20generation)%20-%202024-07-25%20at%2020.24.39.png?alt=media&#x26;token=b28c8cb5-bc54-49aa-9ff8-5017ff314852" alt="" width="375"><figcaption></figcaption></figure></div>

If you have one or more apps:

<div align="left"><figure><img src="https://1008176080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw1fcw3dvtSrfUh3YtO9Z%2Fuploads%2FMPZpi8R62jTuLjOnXK0N%2FSimulator%20Screenshot%20-%20iPhone%20SE%20(2nd%20generation)%20-%202024-07-25%20at%2020.26.59.png?alt=media&#x26;token=2ef9bd97-b249-4190-b898-9165b164656c" alt="" width="375"><figcaption></figcaption></figure></div>

A placeholder icon and title will be used until you configure the app for the first time. Once configured, the app metadata record will be updated and contain the app's actual icon, name and version number extracted from the app's [Info.plist](https://docs.electricbolt.co.nz/additional-reading/info.plist-options#standard-info.plist-behaviour).

![](https://1008176080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw1fcw3dvtSrfUh3YtO9Z%2Fuploads%2Fp6mv7ydSFt0cKsnsaqi0%2Fimage.png?alt=media\&token=c3635fe7-d4b5-4820-8f62-3a51ad575b0b)

## Configuring an app

Tap on an app row to configure the app. If the app is installed on the device, then:

* **iOS:** the app will be run and made visible, it's configuration read, and then swap back to Appfigurate. You *may* be prompted with a dialog in the app to 'Open Appfigurate'. Click `Yes`. (This dialog will be displayed only once).
* **watchOS:** the companion iOS app will be run and made visible. The companion iOS app will read the watchOS apps configuration, then swap back to Appfigurate. You *may* be prompted with a dialog in the app to 'Open Appfigurate'. Click `Yes`. (This dialog will be displayed only once).

If the app is not installed on the device, then a dialog will be displayed with text similar to "The app *Example* is not installed on this *iPhone Simulator*".

If the configuration was read successfully, the [Configure app](https://docs.electricbolt.co.nz/appfigurate-user-guide/configure-app) screen is displayed.

{% hint style="success" %}
Very occasionally, your app will remain visible while trying to read the configuration, instead of swapping back to Appfigurate. In this instance, manually swap back to Appfigurate and try again. The second time will succeed.
{% endhint %}

{% hint style="info" %}
If you're attempting to configure a watchOS app, it must must be actively running in the foreground (the screen will appear at peak brightness) - the easiest way to confirm is to simply touch the screen before attempting to read or apply configuration. If the screen is dimmed, the watch is in a low power mode and the watch won't be able to communicate with it's paired iOS device.&#x20;

The following error dialog will be displayed in your companion iOS app when low power mode is in effect:

![](https://1008176080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw1fcw3dvtSrfUh3YtO9Z%2Fuploads%2FvolBQItnUtqfhj8WLfJo%2Fnoconnection.png?alt=media\&token=6ea4d31d-8382-4d40-9f99-fec3b87b9cab)
{% endhint %}

## Editing an app

Swipe the row from left to right to display an Edit button. Tapping the Edit button will display the [Edit app](https://docs.electricbolt.co.nz/appfigurate-user-guide/edit-app) screen.

![](https://1008176080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw1fcw3dvtSrfUh3YtO9Z%2Fuploads%2FQ6durIKopouXSyukx7H4%2FUntitled.png?alt=media\&token=ef63b123-6bdf-43c6-8c6c-319b378141f0)

## Deleting an app

Swipe the row from right to left to display a Delete button. Tapping the Delete button will first confirm that you want to delete the app, then delete the app's metadata record from the local database.&#x20;

![](https://1008176080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw1fcw3dvtSrfUh3YtO9Z%2Fuploads%2FXkTYgjKv55uy3t9d6uxb%2Fimage.png?alt=media\&token=5c6afc5a-3ade-4e6a-9b30-67ab13779889)

{% hint style="danger" %}
**Caution:** If you haven't got a backup of the app's metadata record, then once it's deleted the app metadata record (specifically the private key) is gone forever.
{% endhint %}