Repository navigation
Releases
Releases · seyedmostafahasani/react-native-splash-motion
0.1.1
What's Changed
- feat: add
--keep-backgroundoption to CLI for retaining full-canvas background solids in animations by @seyedmostafahasani in f56e759 - docs: add Rive animation support to README by @seyedmostafahasani in 3131cfd
Full Changelog: 0.1.0...0.1.1
0.1.0
react-native-splash-motion 0.1.0
First release of react-native-splash-motion: an animated splash screen for React Native that plays a Lottie or dotLottie animation as a native overlay from the moment the app launches, before the JavaScript bundle has loaded, and then hands off smoothly to your app.
Highlights
- Animated from first launch. The animation starts natively at app start-up, so there is no static splash followed by a jump to motion.
- Lottie and dotLottie support. Use
.json(Lottie) or.lottie(dotLottie) files, with no native code to write. - Simple API. Call
SplashMotion.hide()when your app is ready, or use theuseHideSplash(ready)hook. Check state withSplashMotion.isVisible(). - Smooth hand-off. Options such as
waitForLoop,outro,minDurationandfadelet the current loop finish, play an outro marker, enforce a minimum display time and fade out cleanly. - CLI setup.
npx splash-motion generate <animation>configures the native launch screen for iOS and Android, including background colour, size and a first-frame still image. - Expo config plugin. Add
react-native-splash-motionto your Expo config (development build required). - Built on Nitro Modules. Requires
react-native-nitro-modules.
Requirements
- React Native with the New Architecture enabled
- iOS 15+ and Android 7+ (API 24)
Getting started
yarn add react-native-splash-motion react-native-nitro-modules
npx splash-motion generate ./splash.lottie --background "#FFFFFF"import SplashMotion from 'react-native-splash-motion';
await SplashMotion.hide({ outro: 'outro', fade: 220 });See the README for full documentation.
Full Changelog: https://github.com/seyedmostafahasani/react-native-splash-motion/commits/0.1.0