Skip to main content

Change the Splash Screen Logo

The splash screen is native so the app shows branded UI immediately while the React Native bundle loads. Update it during white-labeling together with the app icon and display name.

Quick Answer​

Replace the native launch/splash assets for iOS and Android, update any layout or color resources, rebuild the app, and verify startup on real devices and simulators. Do not rely only on JavaScript for the first launch screen.

1. Prepare Splash Assets​

Prepare:

  • logo asset with transparent background if the layout expects it;
  • light and dark mode variants if your app supports them;
  • background color values;
  • brand-safe layout for small and large devices.

Keep splash assets separate from the app icon. They usually need different padding and aspect ratio.

2. Update iOS Launch Screen​

Find the active launch screen files:

find ios -iname "*LaunchScreen*"
find ios -iname "*.xcassets"

Common iOS files include:

  • LaunchScreen.storyboard;
  • LaunchScreen.xib;
  • image assets inside an .xcassets catalog.

Open the workspace in Xcode:

open ios/*.xcworkspace

Update the image, constraints, and background color used by the app target.

3. Update Android Splash Screen​

Search for splash resources:

rg "launch_screen|splash|windowSplash|ic_launcher" android/app/src/main/res android/app/src/main/AndroidManifest.xml

Common Android files include:

  • drawable XML files for splash background;
  • image assets in drawable-* or mipmap-*;
  • theme values that reference splash resources.

Replace the image assets and update colors or XML references as needed.

4. Rebuild and Verify​

corepack yarn ios
corepack yarn android

Check:

  • cold start;
  • app relaunch;
  • light mode;
  • dark mode, if supported;
  • small and large devices;
  • release build if the splash differs by configuration.

Verification Checklist​

  • No old logo appears on launch.
  • Splash background matches brand color.
  • Logo is centered and not distorted.
  • Splash works on iOS and Android.
  • Dark mode does not show unreadable assets.
  • Store screenshots and app icon match the same branding.

Troubleshooting​

ProblemFix
Old splash still appearsClean build, delete the app from device, and rebuild.
Android shows a blank screenCheck drawable references and theme values.
iOS layout is off-centerUpdate storyboard/xib constraints in Xcode.
Dark mode has wrong colorsAdd dark mode assets or override background colors.
Release differs from debugCheck build variants, asset catalogs, and resource qualifiers.

Next Steps​