react-native-bootsplash

https://github.com/zoontek/react-native-bootsplash/assets/1902323/25179bac-bb9b-4d9b-b1ca-28a4bd01d567

What's new

• An expo plugin 🧩
• A ready option in useHideAnimation config in order to delay your animation, if you want to wait for something else than just layout rendering + images loading 🚦
• A new Android theme: Theme.BootSplash.TransparentStatus (for transparent status bar + opaque navigation bar) 🫥

What else?

• --assets-output now has a default value, which is assets/bootsplash. These assets will always be generated, as it's required for expo or the useHideAnimation hook (assets/bootsplash_logo.png become assets/bootsplash/logo.png, etc.)
• All iOS assets are now suffixed with a short hash of the different splash screen items to prevent caching issues (before, it was only the logo).
• iOS implementation now always uses a colorset for background color, even if you choose not to support dark mode (before it was inlined in the .storyboard file in such case).

Migration

• Delete your previously generated assets directory.
• Run the CLI to generate assets in updated locations.
• That's all ✨

• Fix UILaunchStoryboardName in Info.plist by @elliotdickison in https://github.com/zoontek/react-native-bootsplash/pull/573

• Fix regression in parseColor with full hexadecimal color values, introduced in 5.5.1

• Fix generator hex color shorthand parsing issue: #F0F was expanded to #F0FF0F, instead of #FF00FF.

• Bridgeless mode support (will be the default with new architecture enabled on React Native 0.74)
• Fix splash screen reappearing during screen transitions on Android when Activity has been killed - #553 by @Protino
• Use system scheme instead of the one returned by useColorScheme in useHideAnimation, as it can be overridden by Appearance.setColorScheme (fix #565)

• Targets membership on BootSplash.storyboard / Colors.xcassets generation to avoid opening Xcode to tick the checkboxes (fix #544)

• Remove two steps from the iOS setup process:
  • BootSplash.storyboard and Colors.xcassets are now automatically added to your Xcode project
  • BootSplash.storyboard is now automatically set as UILaunchStoryboardName in your Info.plist

• The CLI generator now suffixes the iOS assets filenames with a hash of the file (kinda like webpack with chunks filenames) in order to invalidate springboard cache (see this article for more infos)

• Fix AndroidManifest.xml namespace deprecation warning

• Update default darkContentBarsStyle value for easier light / dark themes handling

• Add darkContentBarsStyle android custom style property in Theme.BootSplash.EdgeToEdge

Example with [email protected], which has the same feature:

<resources>
  <style name="AppTheme" parent="Theme.EdgeToEdge">
    <item name="android:editTextBackground">@drawable/rn_edit_text_material</item>
    <item name="darkContentBarsStyle">true</item>
  </style>

  <style name="BootTheme" parent="Theme.BootSplash.EdgeToEdge">
    <item name="bootSplashBackground">@color/bootsplash_background</item>
    <item name="bootSplashLogo">@drawable/bootsplash_logo</item>
    <item name="darkContentBarsStyle">true</item>
    <item name="postBootSplashTheme">@style/AppTheme</item>
  </style>
</resources>

• Fix new architecture compatibility for React Native 0.73 (closes #520)

• Introduce a Status based lifecycle on Android to avoid relying on nullability (fix #510)
• Rollback hiding the splash screen on activity pause (fix #512)

• Android Gradle plugin 8 compatibility (by @mikehardy - #509)
• Keep a separate fading dialog instance (when fade option is true) (attempt to fix https://github.com/zoontek/react-native-bootsplash/issues/510)
• Keep bootSplashBrand default to a transparent pixel (more resilient than @null)

• Fix android.graphics.drawable.Drawable.isProjected() on a null object reference issue on old Android versions when no brand image is available.

• Keep half-sized logo on Samsung OneUI v4 to avoid a logo size jump (as Samsung logo size computation is incorrect on this version of their OS, there's not a lot of choices - see https://github.com/zoontek/react-native-bootsplash/issues/466)
• Set android:forceDarkAllowed to false in Theme.BootSplash (might fix #497)
• Allow logo to be undefined in useHideAnimation config
• Update the CLI generator to use prettier v3
• Improve the CLI generator Gumroad issues reporting (when using a 🔑 license key)

• Update sharp to solve CVE-2023-4863 (closes #494)

• Fix an issue that occurred when MainActivity was not attached to window manager (fixes #488)

• Use setOwnerActivity to avoid static field leak (https://github.com/zoontek/react-native-bootsplash/commit/6e21f485c39a8b002ee038732cb0e58a2459453c)

• Avoid creating multiple Dialog instances when hide is called multiple times (https://github.com/zoontek/react-native-bootsplash/commit/20007acce4f8b2f8e3fd17c2727098b61d517e73)