Learn how to use a splash screen, fonts and images in your app that is using Expo Router.
There are three major elements that you can use to customize the appearance of your app:
Expo Router extends the expo-splash-screen
API to prevent white flash. Use it in conjunction with expo-font
to keep the splash screen visible while fonts are loading:
import {
SplashScreen,
// This example uses a basic Layout component, but you can use any Layout.
Slot,
} from 'expo-router';
import { useFonts, Inter_500Medium } from '@expo-google-fonts/inter';
SplashScreen.preventAutoHideAsync();
export default function Layout() {
const [fontsLoaded, fontError] = useFonts({
Inter_500Medium,
});
useEffect(() => {
if (fontsLoaded || fontError) {
// Hide the splash screen after the fonts have loaded (or an error was returned) and the UI is ready.
SplashScreen.hideAsync();
}
}, [fontsLoaded, fontError]);
// Prevent rendering until the font has loaded or an error was returned
if (!fontsLoaded && !fontError) {
return null;
}
// Render the children routes now that all the assets are loaded.
return <Slot />;
}
In SDK 50 and above, Expo Router's static rendering provides automatic static optimization for font loading on web. This enables best practices for working with fonts in the browser.
We recommend you use Expo Image for the best cross-platform experience:
For more information on how to install and use expo-image, see its API documentation.
In Expo Router v3 and greater, you can import SplashScreen from
expo-splash-screen
directly.
Splash screens are required on native platforms. Expo Router automatically orchestrates the native splash screen to keep it visible until the first route is rendered, this applies to any route that the user deep links into. To enable this functionality, install expo-splash-screen
in your project.
The default behavior is to hide the splash screen when the first route is rendered, this is optimal for the majority of routes. For some routes, you may want to prolong the splash screen until additional data or asset loading has concluded. This can be achieved with the SplashScreen
module from expo-router
. If SplashScreen.preventAutoHideAsync
is called before the splash screen is hidden, then the splash screen will remain visible until the SplashScreen.hideAsync()
function has been invoked.
import { Text } from 'react-native';
import * as SplashScreen from 'expo-splash-screen';
SplashScreen.preventAutoHideAsync();
export default function App() {
const [isReady, setReady] = React.useState(false);
React.useEffect(() => {
// Perform some sort of async data or asset fetching.
setTimeout(() => {
// When all loading is setup, unmount the splash screen component.
SplashScreen.hideAsync();
setReady(true);
}, 1000);
}, []);
return <Text>My App</Text>;
}
Expo Router comes with the react-native-safe-area-context
library installed. This library provides a flexible API for accessing device-safe area inset information for both Android and iOS.
To use it, import the SafeAreaProvider
component from react-native-safe-area-context
and wrap your root layout with it:
%%placeholder-start%%Other import statements %%placeholder-end%%
import { SafeAreaProvider } from 'react-native-safe-area-context';
function RootLayoutNav() {
const colorScheme = useColorScheme();
return (
<SafeAreaProvider>
<Stack>
<Screen name="index" options={{ headerShown: false }} />
</Stack>
</SafeAreaProvider>
);
}
On a page component, you can use <SafeAreaView>
component or useSafeAreaInsets
hook to access the safe area insets and use them with <View>
. The following example shows how to use useSafeAreaInsets
:
import { StyleSheet, View, Text } from "react-native";
import { useSafeAreaInsets } from "react-native-safe-area-context";
export default function TabOneScreen() {
const insets = useSafeAreaInsets();
return (
<View style={[styles.container, { paddingTop: insets.top }]}>
<Text style={styles.title}>Home page</Text>
</View>
);
}
React Navigation navigators <Stack>
, <Drawer>
, and <Tabs>
use a shared appearance provider. In React Navigation, you set the theme for the entire app using the <NavigationContainer />
component. Expo Router manages the root container so that you can set the theme using the ThemeProvider
directly.
import { ThemeProvider, DarkTheme, DefaultTheme, useTheme } from '@react-navigation/native';
import { Slot } from 'expo-router';
export default function RootLayout() {
return (
<ThemeProvider value={DarkTheme}>
<Slot />
</ThemeProvider>
);
}
You can use this technique at any layer of the app to set the theme for a specific layout. The current theme can be accessed with useTheme
from @react-navigation/native
.
The @react-navigation/elements
library provides a set of UI elements and helpers that can be used to build a navigation UI. These components are designed to be composable and customizable. You can reuse the default functionality from the library or build your navigator's UI on top of it.
To use it with Expo Router, you need to install the library:
-
npm install @react-navigation/elements
-
yarn add @react-navigation/elements
To learn more about the components and utilities the library provides, see Elements library documentation.