> For the complete documentation index, see [llms.txt](https://docs.buildnatively.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildnatively.com/natively-platform/appearance/app-icon.md).

# App Icon

Your app icon the first thing users will see when they install your application.

{% hint style="warning" %}
An app icon is strictly required to generate your app build. Without configuring an app icon, you will not be able to create a final build.
{% endhint %}

### Configure Your App Icon

Natively offers two automated ways to set up your app icon using our integrated AI generation tools. Navigate to **Appearance > App Icon** in your dashboard to get started.

#### Option 1: Generate from a Text Description

If you don't have a pre-made asset, you can use AI to generate a custom icon directly from a text prompt as shown in the screenshot.

1. Select the **Describe with AI** tab.
2. In the **Describe your icon** text field, type a detailed prompt.
   * *Tip: Be specific about the subject, style, and colors (e.g., "A minimalist purple rocket on a deep navy gradient, glossy and modern").*
3. Alternatively, click one of the quick suggestions below the input box (such as *"Minimal fitness app"* or *"Abstract geometric logo"*).
4. Click the **Generate icon** button.

In few seconds you will see the result.

<figure><img src="https://3352617162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F90tV7pYflEQdiAr2VfWu%2Fuploads%2FLBks0Z8WZOo3qdCqJ1Ed%2Fnatively_app_icon_generation.png?alt=media&amp;token=07c3feb3-9433-4dcb-adf9-b5c01e4746d5" alt=""><figcaption></figcaption></figure>

#### Option 2: Generate from an Uploaded Image

If you have a reference image, logo, or rough sketch, you can use it as a base for the AI generation tool.

1. Select the **Upload image** tab next to the text prompt option.
2. Upload your source file.\
   **File Requirement:** The uploaded image must be in PNG or JPG format.
3. The tool will process your asset into a standardized mobile app icon layout.

<figure><img src="https://3352617162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F90tV7pYflEQdiAr2VfWu%2Fuploads%2FWrSSE88Mx7Vth54UW0lU%2Fnatively_app_icon_upload.png?alt=media&amp;token=1c07fdc2-b94d-4a20-8cb8-c0bc9d71bc3e" alt=""><figcaption></figcaption></figure>

### Previewing and Managing Results

Once an icon is processed, it will automatically populate your layout and display a realistic mockup on the phone preview on the right side of the screen, as seen in the screenshot.

<figure><img src="https://3352617162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F90tV7pYflEQdiAr2VfWu%2Fuploads%2FdO2SMOFv3MlqivnfOWpw%2Fnatively_app_icon_result.png?alt=media&amp;token=602bfe33-4a5e-4f03-81d3-165c43de4a6a" alt=""><figcaption></figcaption></figure>

* **Not happy with the result?** If the generated icon doesn't look quite right, you can easily delete it by clicking the red **Trash Can** icon. Once deleted, you can tweak your prompt or upload a different image and try again.
* When you are satisfied with the icon preview, click **Next** to save your changes and continue setting up your app's appearance.