as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
AWS
Documentation
Support
Contact Us
My Cases
Get Started
Design and Develop
Publish
Reference
Support

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

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

    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 npm install command.

Examples

You need to create top-level <PROJECT_ROOT>/assets/raw directory and there you need to place zip named SplashScreenImages.zip with desc.txt file (example content below) and _loop folder with splash.png file.

Folder structure:

Copied to clipboard.

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

Example content of desc.txt file:

Copied to clipboard.

1920 1080 30
c 0 0 _loop

Splash screen example

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

Check out the dedicated documentation page for info about this library, API reference and more: Official Expo documentation for expo-splash-screen.

Methods

Method Description
hideAsync Hides the native splash screen immediately. Be careful to ensure that your app has content ready to display when you hide the splash screen, or you may see a blank screen briefly. See the "Usage" section for an example
preventAutoHideAsync Makes the native splash screen remain visible until hideAsync is called

Implementation details

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

Supported versions

Package Version Based On @amazon-devices/react-native-kepler version
2.0.x 0.24.0 2.0.x

Additional resources

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


Last updated: Sep 30, 2025