|
| 1 | +--- |
| 2 | +slug: app-assets |
| 3 | +title: App Assets |
| 4 | +tags: [assets, splash screen, launcher icon, adaptive icon] |
| 5 | +keywords: [assets, splash screen, launcher icon, adaptive icon] |
| 6 | +description: Learn how to configure app assets for your FlutterFlow app. |
| 7 | +sidebar_position: 1 |
| 8 | +--- |
| 9 | + |
| 10 | +# App Assets |
| 11 | + |
| 12 | +This allows you to upload the images to be used by the app. From here, you can upload the Initial splash image and the image for the app launcher icon. |
| 13 | + |
| 14 | +## Splash |
| 15 | + |
| 16 | +Splash screens are the first thing users see when your app starts up. They give the app time to get ready while showing you something fun or informative. This screen typically contains the image or logo of the app. |
| 17 | + |
| 18 | +The steps to configure the splash screen are as follows: |
| 19 | + |
| 20 | +1. Navigate to the **Setting and Integrations** from the Navigation Menu > **General** section > **App Assets**. |
| 21 | + |
| 22 | +2. Under the **Splash** section, click on the **Upload Image** button and upload the image you would like to display on the splash screen. |
| 23 | +3. You can try any of the **Image Fit** options to determine how the uploaded image should display on the splash screen. |
| 24 | +4. To control the image dimension by yourself, you can set the **width** and **height** properties. |
| 25 | + - To set an **exact size,** select **PX** and enter the desired values. |
| 26 | + - To set the dimensions as a **% of the screen size**, select **%** and enter the desired value. |
| 27 | +5. The **Min Duration** property helps you set the time for which the splash screen will be visible, where (1000ms = 1 second). |
| 28 | +6. You can also set a **Background Color** to match the background of the image. |
| 29 | +7. In mobile apps, you might occasionally notice a blank white screen briefly appearing (as the Flutter engine loads) before the splash screen is displayed. To change the color of this screen, use the **Pre-loading** Color property. |
| 30 | +8. Typically, web apps don't use a splash screen, so If you prefer a more traditional web experience, you can choose to **Disable for Web**. |
| 31 | + |
| 32 | + |
| 33 | + |
| 34 | +## Launcher Icon |
| 35 | + |
| 36 | +The launcher icon (also known as the app icon) represents your application. When you open the launcher app, it shows the app icons for all the installed apps. It acts as an entry point for your app. The image asset that you will upload here will be used as the app launcher icon. |
| 37 | + |
| 38 | +To add the app launcher icon: |
| 39 | + |
| 40 | +1. Click on the **Setting and Integrations** from the Navigation Menu (left side of your screen). |
| 41 | +2. Under the **General** section, select **App Assets**. |
| 42 | +3. Under the **Launcher Icon** section, click on the **Upload Image** button. |
| 43 | +4. By clicking on the **Unset** dropdown menu, you can also select from the already uploaded images to the Project Media/Assets. |
| 44 | +5. [Download the project](../../../testing-deployment-publishing/exporting-code/ff-cli.md) and run the following command in your terminal to generate the launcher icon: |
| 45 | + |
| 46 | + `flutter pub run flutter_launcher_icons:main` |
| 47 | + |
| 48 | +6. [Run your app](../../../testing-deployment-publishing/running-your-app/run-your-app.md) on a real device or emulator to see the app launcher icon. |
| 49 | + |
| 50 | + |
| 51 | +## Android Adaptive Icon |
| 52 | + |
| 53 | +[Adaptive icons](https://developer.android.com/develop/ui/views/launch/icon_design_adaptive) are a design specification that allows app icons to adapt to different device environments without losing consistency in appearance. Unlike traditional launcher icons, which are static and can appear out of place or poorly scaled on different devices, adaptive icons consist of two layers: |
| 54 | + |
| 55 | +1. **Foreground layer**: This layer usually contains the logo or main visual element of the icon. |
| 56 | +2. **Background layer**: This provides a fill (color or background image) behind the foreground, which can be manipulated by the device’s software. |
| 57 | + |
| 58 | +Here are the steps to add adaptive icons: |
| 59 | + |
| 60 | +1. [Create an adaptive icon](https://developer.android.com/develop/ui/views/launch/icon_design_adaptive#design-adaptive-icons). You can either use this [online tool](https://icon.kitchen/) or use these [resources](#create-adaptive-icon) to create one. |
| 61 | +2. Return to FlutterFlow and navigate to **Setting and Integrations > General** > **App Assets > Android Adaptive Icon.** |
| 62 | + 1. Upload the **Foreground Icon**. If you use the online tool, you'll find it inside the `IconKitchen-Output > android > res > mipmap-xxxhdpi > ic_launcher_foreground.png`. |
| 63 | + 2. For **Background Type**, you can either set the **Color** or **Image**. It's recommended to use a color that aligns with your app's branding for a cohesive look. |
| 64 | +3. [Download the project](../../../testing-deployment-publishing/exporting-code/ff-cli.md) and run the following command in your terminal to generate the launcher icon: |
| 65 | + |
| 66 | + `flutter pub run flutter_launcher_icons:main` |
| 67 | + |
| 68 | +4. [Run your app](../../../testing-deployment-publishing/running-your-app/run-your-app.md) on a real device or emulator to see the app launcher icon. |
| 69 | + |
| 70 | + |
| 71 | + |
| 72 | +### Useful resources |
| 73 | + |
| 74 | +See the following resources for more information on Android adaptive icons. |
| 75 | + |
| 76 | +### Create Adaptive Icon |
| 77 | + |
| 78 | +- [Create app icons in Android Studio](https://developer.android.com/studio/write/create-app-icons#create-adaptive) |
| 79 | +- [Figma template](https://material.uplabs.com/posts/adaptive-icon-sticker-sheet) (requires login) |
| 80 | +- [Affinity Designer template](https://cyrilmottier.com/2017/07/06/adaptive-icon-template/) |
| 81 | +- [Bjango templates](https://github.com/bjango/Bjango-Templates) include adaptive icons |
| 82 | +- [Adobe XD template](https://github.com/faizmalkani/adaptive-icon-template-xd) |
| 83 | + |
| 84 | +### Adaptive Icon Fundamentals |
| 85 | + |
| 86 | +- [Understanding Android Adaptive Icons](https://medium.com/google-design/understanding-android-adaptive-icons-cee8a9de93e2) |
| 87 | +- [Designing Adaptive Icons](https://medium.com/google-design/designing-adaptive-icons-515af294c783) |
| 88 | +- [Implementing Adaptive Icons](https://medium.com/google-developers/implementing-adaptive-icons-1e4d1795470e) |
0 commit comments