# Add app

The Add app screen starts the flow that allows you to add a new app with a randomly generated private key.

{% hint style="info" %}
**Hint:** If you already have an existing iOS app metadata record, and you want your watchOS app to have the same public/private keypair, then use the [Duplicate app](/appfigurate-user-guide/edit-app.md#duplicate-app) function instead. 
{% endhint %}

<div align="left"><figure><img src="/files/WDbwHdUOHQXVDufSVfuH" alt="" width="375"><figcaption></figcaption></figure></div>

Choose one of the following:

* **iOS:** If you have an iOS app (or iPadOS) app and optionally an app extension.
* **watchOS:** If you have a companion watchOS app. The URL scheme of the watchOS app must be the same as the containing iOS app, as the iOS app is used to proxy the configuration payloads to the watchOS app.

Tap the `Next` button to continue.

Enter the unique URL Scheme that will be used to launch your app. Whilst we suggest using the auto-generated value, you can enter any 4-20 character string.

* **iOS:** The URL Scheme you enter here will need to be entered into your app's [Info.plist CFBundleURLTypes](https://docs.electricbolt.co.nz/appfigurate-user-guide/pages/15YH8YZPl3k8bnWiWxdw#edit-info.plist).
* **watchOS:** The URL Scheme you enter here just needs to match the URL Scheme you use for the containing iOS app, as your iOS app is used to proxy the configuration payloads to the watchOS app.

<div align="left"><figure><img src="/files/dr2i2fPxXKVDsuyMaEll" alt="" width="375"><figcaption></figcaption></figure></div>

Tap `Add` to generate a random 2048 bit RSA private key. This can take a few seconds. Once generated your app metadata record will be saved into the local database and the [Select app](/appfigurate-user-guide/select-app.md) screen displayed.


---

# 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-user-guide/add-app.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.