expo-splash-screen

The @amazon-devices/expo-splash-screen library is used to tell the splash screen to remain visible until it has been explicitly told to hide. This is useful to do tasks that will happen behind the scenes such as making API calls, pre-loading fonts, animating the splash screen and so on.

• Installation
• Examples
• API reference
  • Methods
• Known issues and limitations
• Supported versions
• Related topics

Installation

1. Add the JavaScript library dependency in the package.json file:

   Copy code Copied to clipboard.

    "dependencies": {
        ...
        "@amazon-devices/expo-splash-screen": "~2.0.0",
        "@amazon-devices/keplerscript-turbomodule-api": "~1.0.0",
        ...
            }
   
    "overrides": {
        "@amazon-devices/react-native-kepler": "~2.0.0"
        },
   

2. Reinstall dependencies using the npm install command.

Examples

Create a top-level <PROJECT_ROOT>/assets/raw directory. Place a zip file named SplashScreenImages.zip with a desc.txt file (see the following example content) and a _loop folder with a splash.png file.

Folder structure:

Copy code Copied to clipboard.

├── assets/
├──── raw/
├────── SplashScreenImages.zip
...
├── src/
...
├── manifest.toml

Example content of desc.txt file:

Copy code Copied to clipboard.

1920 1080 30
c 0 0 _loop

Splash screen example

Copy code Copied to clipboard.

import {hideAsync, preventAutoHideAsync} from '@amazon-devices/expo-splash-screen';
import React from 'react';
import {useEffect} from 'react';
import {StyleSheet, Text, View} from 'react-native';

preventAutoHideAsync();

export const App = () => {
  useEffect(() => {
    // perform your operations before calling hide async
    setTimeout(() => {
      hideAsync();
    }, 2000);
  }, []);

  return (
    <View style={styles.container}>
      <Text style={styles.text}>SplashScreen Demo! 👋</Text>
    </View>
  );
};

const styles = StyleSheet.create({
  container: {
    flex: 1,
    backgroundColor: 'white',
    alignItems: 'center',
    justifyContent: 'center',
  },
  text: {
    color: 'black',
    fontSize: 32,
  },
});

API reference

See the documentation page for more information about this library and API reference: Official Expo documentation for expo-splash-screen.

Methods

Known issues and limitations

Splash screen doesn't work on the Vega Virtual Device.

Supported versions

Related topics

For information on additional libraries, see Supported Third-Party Libraries and Services.

Last updated: Sep 30, 2025