How do I install RevealingSplashView in my iOS project?

Install via CocoaPods by adding 'pod RevealingSplashView' to your Podfile and running pod install, or via Carthage by adding the GitHub repository to your Cartfile. The README provides step-by-step instructions for both package managers.

Can I use RevealingSplashView with SwiftUI?

RevealingSplashView is built for UIKit, so using it with SwiftUI requires wrapping it in a UIViewControllerRepresentable, which adds complexity. For native SwiftUI animations, consider alternative libraries or custom implementations.

How to change the animation type in RevealingSplashView?

Set the animationType property to one of the predefined types like SplashAnimationType.rotateOut or .heartBeat. The README includes code snippets and GIF examples for each animation type to guide customization.

RevealingSplashView vs building a custom splash screen from scratch

RevealingSplashView saves development time with pre-built animations and easy integration, but if you need unique, complex animations or full control over performance, building from scratch with Core Animation might be more suitable. The library excels for standard, polished effects.

How to handle splash screen when my app has a NavigationController?

The README suggests adding the RevealingSplashView to the UIWindow instead of the ViewController, or using a separate entry view controller to avoid offset issues. This ensures smooth animation transitions without visual glitches.

Does RevealingSplashView support background images?

Yes, you can set a custom background image by initializing with backgroundImage instead of backgroundColor, as shown in the README example. This allows for more immersive splash screen designs matching your app's theme.

Is RevealingSplashView still actively maintained?

The project has badges for build status and code coverage, and a TODO list for improvements like better code coverage. Check the GitHub repository for recent commits and issue activity to assess current maintenance, as it may have slowed over time.

Open-Awesome

RevealingSplashView

MITSwift

A customizable iOS splash screen view with multiple reveal animations, inspired by Twitter's splash screen.

GitHub

1.2k stars85 forks0 contributors

What is RevealingSplashView?

RevealingSplashView is a Swift library for iOS that creates animated splash screens that transition from the launch screen to the main app interface. It solves the problem of static, boring launch screens by providing engaging animations that reveal app content, inspired by popular apps like Twitter.

Target Audience

iOS developers looking to enhance their app's first impression with professional, customizable splash screen animations without building the animation logic from scratch.

Value Proposition

Developers choose RevealingSplashView for its variety of pre-built animations, easy integration with CocoaPods or Carthage, and extensive customization options that allow them to match their app's branding perfectly.

Overview

A Splash view that animates and reveals its content, inspired by Twitter splash

Use Cases

Best For

Adding Twitter-style splash screen animations to iOS apps
Creating custom animated launch screens with multiple animation types
Enhancing user experience during app startup with smooth transitions
Matching splash screen animations to specific app branding requirements
Implementing heartbeat animations for apps that need to wait for background tasks
Quickly prototyping animated splash screens without writing complex animation code

Not Ideal For

iOS apps built exclusively with SwiftUI that prefer native animation frameworks
Cross-platform projects requiring synchronized splash screens on both iOS and Android
Developers needing highly interactive or procedurally generated splash animations beyond the library's preset types
Apps with strict binary size constraints that cannot accommodate additional dependencies

Pros & Cons

Pros

Multiple Animation Presets

Offers seven distinct animation types including Twitter-style, heartbeat, and various zoom-out effects, all demonstrated with GIFs in the README, eliminating the need to code common animations from scratch.

Easy Setup and Integration

Simple API with minimal code required; can be added via CocoaPods or Carthage and initialized in viewDidLoad() with clear examples, making it accessible for quick implementation.

Extensive Branding Customization

Allows full control over icon image, color, size, background color, and background image, as detailed in the usage section, enabling precise alignment with app design.

Flexible Timing for Background Tasks

Heartbeat animation can run indefinitely until manually stopped with heartAttack = true, useful for apps that need to wait for network calls or data loading without interrupting the user experience.

Cons

UIKit-Only Compatibility

Designed for UIKit-based apps, making integration with SwiftUI projects cumbersome and requiring additional bridging code, which limits its use in modern iOS development.

NavigationBar/TabBar Alignment Issues

The README acknowledges that animations may appear offset when used with NavigationBar or TabBar, necessitating workarounds like adding to the UIWindow or creating a separate entry view controller.

Fixed Animation Library

Limited to preset animations; the TODO list mentions adding more, but there's no built-in support for creating custom animations without modifying the source code, reducing flexibility for unique designs.

Frequently Asked Questions

Related Projects

Hero

Elegant transition library for iOS & tvOS

Stars22,460

Forks1,737

Last commit1 year ago

Cards

Awesome iOS 11 appstore cards in swift 5.

Stars4,207

Forks271

Last commit3 years ago

StarWars.iOS

This component implements transition animation to crumble view-controller into tiny pieces.

Stars3,769

Forks359