Skip to content

Hide transitions

Transitions run on the native content retained by the package, not the operating system's earliest Launch Screen.

Transition types

TransitionEffectGood fit
noneRemove immediatelyFastest handoff and Android system mode
fadeFade opacityMost static launch artwork
scaleFadeScale up and fadeA logo expanding outward
slideUpFadeMove up and fadeContent entering from below
zoomOutFadeScale down and fadeThe first screen moving forward

Usage

ts
SplashScreen.hide({ animation: 'fade' });

SplashScreen.hide({
  animation: 'slideUpFade',
  duration: 250,
  easing: 'easeInOut',
});

SplashScreen.hide({
  animation: 'zoomOutFade',
  duration: 250,
  scale: 0.92,
  easing: 'easeOut',
});

Defaults

OptionDefaultConstraint
duration250 ms when animated; 0 for noneNegative values become 0
scale1.08 for scaleFadeClamped to 1.0-1.3
scale0.92 for zoomOutFadeClamped to 0.7-1.0
easingeaseOutlinear, easeIn, easeOut, or easeInOut

Platform behavior

  • Android dialog: transitions run on the splash content view over a transparent Dialog window.
  • Android system: exits the system splash directly and does not run package transitions.
  • iOS: transitions run on the native overlay created from the Launch Screen storyboard.

Design guidance

  • Keep exits around 180-320 ms so prepared content is not obscured for too long.
  • Match the launch artwork and first-screen background colors to reduce visible flashes.
  • Do not use a fixed delay. Call hide() as soon as the first screen is ready.
  • Both platforms skip transitions when the user or system has disabled motion.

Released under the MIT License.