Jelly provides custom view controller transitions with just a few lines of code. No need to create your own PresentationController or Animator-Objects. A Jelly-Animator will do the heavy lifting for you.

You can use Jelly to build your own Alert-Views or Slidein-Menus using ViewControllers designed by yourself.

To run the example project, clone the repo, and run pod install from the Example directory first.

Jelly is super easy to use.

1. Create a JellyPresentation Object
2. Initialize a JellyAnimator using the JellyPresentation Object created in Step 1.
3. Call the prepare(viewController:UIViewController) Function
4. Finally call the native UIViewController presentation function.

override func viewDidLoad() {
    super.viewDidLoad()
    let viewController = self.storyboard.instantiateViewController(withIdentifier: "someViewController")
    let presentation = JellySlideInPresentation()
    self.jellyAnimator = JellyAnimator(presentation:presentation)
    self.jellyAnimator?.prepare(viewController: viewController)
    self.present(viewController, animated: true, completion: nil)
}

DO NOT FORGET TO KEEP A STRONG 💪 REFERENCE

Because the transitioningDelegate of a UIViewController is weak, you need to hold a strong reference to the JellyAnimator inside the UIViewController you are presenting from

class CustomVC : UIViewController {
    var jellyAnimator: JellyAnimator?
    override func viewDidLoad() {
        super.viewDidLoad()
        // Setup your Animator here 
        // ....
        // And assign it
        self.jellyAnimator = createAnimator()
    }
}

That's it. That's lit.

Jelly Supports two types of Presentations.

• JellySlideInPresentation
• JellyFadeInPresentation

Both share some propertys and each Property has a default value

• duration: JellyConstants.Duration (default: normal)
  • ultraSlow = 2.0
  • slow = 1.0
  • medium = 0.5
  • normal = 0.35
  • fast = 0.2
  • reallyFast = 0.1
• widthForViewController: JellyConstants.Size (default: fullscreen)
  • If the container is smaller than the provided width Jelly will automatically resize to the containers width
  • if Margin Guards are specified they also will be applied if width is to wide for the container
• heightForViewController: JellyConstants.Size (default: fullscreen)
  • If the container is smaller than the provided height Jelly will automatically resize to the containers width
  • if Margin Guards are specified they also will be applied when height is to high for the container
• horizontalAlignment: JellyConstants.HorizontalAlignment (default: .center)
  • center, left or right
• verticalAlignemt: JellyConstants.VerticalAlignment (default:center)
  • top, bottom, center
• marginGuards: default(UIEdgeInsets.zero)
  • If the width or height is bigger than the container we are working with, marginGuards will kick in and limit the size using the specified margins
• backgroundStyle: JellyConstants.BackgroundStyle (default: dimmed)
  • dimmed, blur(effectStyle), none
• cornerRadius: Double (default: 0)
• presentationCurve: JellyConstants.JellyCurve (default: linear)
  • easeIn, easeOut, easeInEaseOut, linear
• dismissCurve: JellyConstants.JellyCurve (default: linear)
  • easeIn, easeOut, easeInEaseOut, linear

JellySlideInAnimation provides 3 extra Properties

• directionShow: JellyConstants.Direction (default: top)
  • left, top, bottom, right
• directionDismiss: JellyConstants.Direction (default: top)
  • left, top, bottom, right
• jellyness: (default: none)
  • none (damping = 1.0, velocity = 0.0)
  • jelly (damping = 0.7, velocity = 2)
  • jellier (damping = 0.5 , velocity = 3)
  • jelliest (damping = 0.2, velocity = 4)

let customPresentation = JellySlideInPresentation(dismissCurve: .linear,
                                                    presentationCurve: .linear,
                                                         cornerRadius: 15,
                                                      backgroundStyle: .blur(effectStyle: .light),
                                                            jellyness: .jellier,
                                                             duration: .normal,
                                                        directionShow: .top,
                                                     directionDismiss: .top,
                                               widthForViewController: .fullscreen, 
                                              heightForViewController: .custom(value:200) ,
                                                  horizontalAlignment: .center,
                                                    verticalAlignment: .top,
                                                         marginGuards: UIEdgeInsets(top: 0, left: 10, bottom: 0, right: 10))


self.jellyAnimator = JellyAnimator(presentation:customPresentation)
self.jellyAnimator?.prepare(viewController: viewController)
self.present(viewController, animated: true, completion: nil)

Your Project at least needs a deployment target that is > iOS 9.0

Jelly is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "Jelly"

• Mentioned in iOS Dev Weekly by @Dave Verwer - Issue NO. 112
• Mentioned in This Week in Swift by @Natasha the Robot - Issue No. 279

Sebastian Boldt, [email protected]

Jelly is available under the MIT license. See the LICENSE file for more info.