Swiftpack.co - PimCoumans/AnimationPlanner as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by PimCoumans.
PimCoumans/AnimationPlanner v1.1.0
Chain multiple UIView animations without endless closure nesting
โญ๏ธ 88
๐Ÿ•“ 51 weeks ago
.package(url: "https://github.com/PimCoumans/AnimationPlanner.git", from: "v1.1.0")

Animation Planner logo


โ›“ Chain multiple UIView animations without endless closure nesting. Create your animation sequence all on the same indentation level using a clear, concise syntax.

๐Ÿคน Used for all exuberant animations in OK Video ๐Ÿ“ฒ

๐Ÿ“– Check out the documentation to get up to speed, or read on to see a little example.

How do I plan my animations?

๐Ÿ“ฆ Add AnimationPlanner to your project (using Swift Package manager) and start typing AnimationPlanner.plan to embark on your animation journey. Like whatโ€˜s happening in the code below.

AnimationPlanner.plan {
    Animate(duration: 0.32, timingFunction: .quintOut) {
        view.alpha = 1
        view.center.y = self.view.bounds.midY
    Animate(duration: 0.32) {
        view.transform = CGAffineTransform(scaleX: 2, y: 2)
        view.layer.cornerRadius = 40
        view.backgroundColor = .systemRed
    AnimateSpring(duration: 0.25, dampingRatio: 0.52) {
        view.backgroundColor = .systemBlue
        view.layer.cornerRadius = 0
        view.transform = .identity
    Animate(duration: 0.2) {
        view.alpha = 0
        view.transform = .identity
        view.frame.origin.y = self.view.bounds.maxY
}.onComplete { finished in

The above code results in the following animation sequence. For more examples see the Sample App available when cloning the repo.

Note: The example uses custom extension methods on CAMediaTimingFunction, included with the framework


๐Ÿ›  Adding AnimationPlanner as a package dependency

  1. Go to File -> Add Packages
  2. Paste https://github.com/PimCoumans/AnimationPlanner in the search bar and click on "Add Package"
  3. Select the target(s) in which you want to use AnimationPlanner

๐Ÿ“ฆ Swift Package Manager

Manually add AnimationPlanner as a package dependency in package.swift, by updating your package definition with:

  dependencies: [
    .package(name: "AnimationPlanner", url: "https://github.com/PimCoumans/AnimationPlanner.git", .branch("main"))

And updating your targetโ€˜s dependencies property with dependencies: ["AnimationPlanner"]

๐Ÿ”ฎ Future plans

While this API removes a lot of unwanted nesting in completion closures when using traditional UIView.animate... calls, a project is never finished and for future versions I have the following plans:

  • Remove usage of inaccurate DispatchQueue.main.asyncAfter, currently used to add delays for non-UIView animations or bridging gaps between steps.
  • Maybe even allow this package to play more nicely with SwiftUI? No idea what that would look like though, any ideas?

Got any feedback or suggestions? Please let me know! โœŒ๐Ÿป

โ†’ twitter.com/pimcoumans


Stars: 88
Last commit: 6 days ago
Advertisement: IndiePitcher.com - Cold Email Software for Startups

Release Notes

6 days ago

Finally: full working sequence stopping!

What's Changed

Full Changelog: https://github.com/PimCoumans/AnimationPlanner/compare/1.1.1...1.2.0

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics