1---
2title: Splash screen
3description: Learn how to create a splash screen for your Expo project and other best practices.
4---
5
6import ImageSpotlight from '~/components/plugins/ImageSpotlight';
7import Video from '~/components/plugins/Video';
8import { Terminal } from '~/ui/components/Snippet';
9import { Collapsible } from '~/ui/components/Collapsible';
10import { BoxLink } from '~/ui/components/BoxLink';
11
12A splash screen, also known as a launch screen, is the first screen a user sees when they open your app. It stays visible while the app is loading. You can also control the behavior of when a splash screen disappears by using the native [SplashScreen API](/versions/latest/sdk/splash-screen).
13
14## Configure the splash screen for your app
15
16The default splash screen is a blank white screen. It can be customized using the `splash` key in the project's [**app.json**](/workflow/configuration).
17
18## Make a splash image
19
20To create a splash image, you can use this [Figma template](https://www.figma.com/community/file/1155362909441341285). It provides a bare minimum design for an icon and splash images for Android and iOS.
21
22For an in-detail walkthrough, see the video below:
23
24<Video url="https://youtu.be/QSNkU7v0MPc" />
25
26### Android
27
28Android screen sizes vary greatly with the massive variety of devices on the market. One strategy to deal with this is to look at the most common resolutions and design around that &mdash; [you can see a list of devices and their resolutions here](https://material.io/resources/devices/). Given that you can resize and crop our splash image automatically, you can stick with our dimensions as long as you don't depend on the splash image fitting the screen exactly. This is convenient because you can use one splash image for Android and iOS &mdash; less for you to read in this guide and less work for you to do.
29
30### iOS
31
32The [iOS Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines/foundations/layout#specifications) list the device's screen sizes. In the video example, we use `1242` pixels wide (the width of the widest iPhone at the moment of writing) and `2436` pixels tall (the height of the tallest iPhone at the moment of writing). Expo will resize the image for you depending on the size of the device's size, and you can specify the strategy used to resize the image with [`splash.resizeMode`](/versions/latest/config/app/#resizemode).
33
34## Export the splash image as a .png
35
36After creating your splash screen, export it as a **.png** and save it in the **assets** directory. **Currently, only .png images are supported**. If you use another image format, making a production build of your app will fail.
37
38### Using `splash.image`
39
40Open the **app.json** and add the path as the value of `splash.image` to point to your new splash image. If you haven't renamed the default file name, it should be `./assets/splash.png`.
41
42```json app.json
43{
44  "expo": {
45    "splash": {
46      "image": "./assets/splash.png"
47    }
48  }
49}
50```
51
52Reopen the Expo Go and launch your project. You should see your new splash screen. However, there may be a delay before it appears in Expo Go. This doesn't happen in development builds or standalone apps. For more information, see [Differences between environments](#differences-between-environments-on-ios).
53
54> On Android, you must press the notification drawer's refresh button. On iOS, it's required to close and re-open the Expo Go to see changes to the splash screen from the **app.json**.
55
56### `splash.backgroundColor`
57
58If you set a background color other than white for your splash image, you may see a white border around it. This is due to the `splash.backgroundColor` property that has a default value of `#ffffff`.
59
60To resolve it, set the `splash.backgroundColor` to be the same as our splash image background color, as shown in the example below:
61
62```json app.json
63{
64  "expo": {
65    "splash": {
66      "image": "./assets/splash.png",
67      "backgroundColor": "#FEF9B0"
68    }
69  }
70}
71```
72
73<ImageSpotlight
74  alt="Splash screen with background color"
75  src="/static/images/backgroundColor-noodles.png"
76/>
77
78### `splash.resizeMode`
79
80Any splash image you provide gets resized to maintain its aspect ratio and fit the resolution of the user's device.
81
82You can use two strategies for resizing: `contain` (default) and `cover`. In both cases, the splash image is within the splash screen. These work similar to the [`resizeMode`](https://reactnative.dev/docs/image/#resizemode) in React Native `<Image>`, as demonstrated below:
83
84<ImageSpotlight alt="Splash screen resize mode" src="/static/images/resizeMode.png" />
85
86Applying this to an example and remove the `backgroundColor`:
87
88```json app.json
89{
90  "expo": {
91    "splash": {
92      "image": "./assets/splash.png",
93      "resizeMode": "cover"
94    }
95  }
96}
97```
98
99Here is the result:
100
101<ImageSpotlight
102  alt="Splash screen resize mode with logo"
103  src="/static/images/resizeMode-noodles.png"
104/>
105
106In the above example, the image is stretched to fill the entire width while maintaining the aspect ratio. This is why the logo on the splash image ends up being larger than when `resizeMode` is set to `contain`.
107
108To learn the difference between `contain` and `cover` in-depth, see [blog post](http://blog.vjeux.com/2013/image/css-container-and-cover.html).
109
110## Custom configuration for Android and iOS
111
112Any of the splash options can be configured on a platform basis by nesting the configuration under the `android` or `ios` in **app.json** (the same as how you would customize an icon for either platform). In addition, certain configuration options are only available on each platform:
113
114- On Android, you can set splash images for [different device DPIs](/versions/latest/config/app/#mdpi) from `mdpi` to `xxxhdpi`.
115
116- On iOS, you can set [`ios.splash.tabletImage`](/versions/latest/config/app/#tabletimage) to have a different splash image on iPads.
117
118<Collapsible summary="Using bare workflow?">
119
120If your app does not use [Expo Prebuild](/workflow/prebuild) (formerly the _managed workflow_) to generate the native `android` and `iOS` directories, then changes in the **app.json** will have no effect. For more information, see [how you can customize the configuration manually](https://github.com/expo/expo/tree/main/packages/expo-splash-screen#-installation-in-bare-react-native-projects).
121
122</Collapsible>
123
124### Splash screen API limitations on Android
125
126On Android, the splash screen behaves in most cases the same as on the iOS. There is a slight difference when it comes down to **standalone Android applications**.
127In this scenario, extra attention should be paid to [`android.splash`](/versions/latest/config/app/#splash-2) section configuration inside **app.json**.
128
129Depending on the `resizeMode` you will get the following behavior on Android:
130
131- **contain** - The splash screen API is unable to stretch or scale the splash image. As a result, the `contain` mode will initially display only the background color, and when the initial view hierarchy is mounted then `splash.image` will be displayed.
132- **cover** - This mode has the limitations as **contain** for the same reasons.
133- **native** - In this mode, your app will be leveraging Android's ability to present a static bitmap while the application is starting up. Android (unlike iOS) does not support stretching the provided image, so the application will present the given image centered on the screen. By default `splash.image` would be used as the `xxxdpi` resource. It's up to you to provide graphics that meet your expectations and fit the screen dimension. To achieve this, use different resolutions for [different device DPIs](/versions/latest/config/app/#mdpi) such as from `mdpi` to `xxxhdpi`.
134
135### Differences between environments on iOS
136
137Your app can be opened from the Expo Go or in a standalone app, and it can be either published or in development. There are slight differences in the splash screen behavior between these environments.
138
139<ImageSpotlight
140  alt="iOS splash screen behavior"
141  src="https://media.giphy.com/media/l378l98EI0VQdwRzy/giphy.gif"
142/>
143
144{/* TODO: (@aman) Remove the second item in the list below. The published app in Expo Go is deprecated. Instead, replace it with development builds using expo-dev-client. */}
145
146- **On the left**, the Expo Go loads the project currently in development. Notice that on the bottom of the splash screen, you see an information bar that shows information relevant to preparing the JavaScript and downloading it to the device. We see an orange screen before the splash image appears because the background color is set immediately. However, the image needs to be downloaded.
147- **In the middle**, Expo Go loads a published app. Notice that again the splash image does not appear immediately.
148- **On the right** is a standalone app. Notice that the splash image appears immediately.
149
150### iOS caching
151
152In custom iOS builds, launch screens can sometimes remain cached between builds, making it harder to test new images. Apple recommends clearing the _derived data_ folder before rebuilding, this can be done with Expo CLI by running:
153
154<Terminal cmd={['$ npx expo run:ios --no-build-cache']} />
155
156See [Apple's guide on testing launch screens](https://developer.apple.com/documentation/technotes/tn3118-debugging-your-apps-launch-screen) for more information.
157
158## Next step
159
160<BoxLink
161  title="App icons"
162  description="An app's icon is what your app users see on their device's home screen and app stores. Learn about how to customize your app's icon and what are the different requirements for Android and iOS."
163  href="/develop/user-interface/app-icons"
164/>
165