onmyway133 / wave

:ocean: Declarative chainable animations in Swift

Wave

Declarative chainable animations in Swift ❤️ Support my apps ❤️

• Push Hero - pure Swift native macOS application to test push notifications
• PastePal - Pasteboard, note and shortcut manager
• Quick Check - smart todo manager
• Alias - App and file shortcut manager
• My other apps

❤️❤️😇😍🤘❤️❤️

Features

• Declarative
• Run animations in sequence
• Run animations in parallel
• Support UIView and Core Animation animations
• Extensible

Usage

view.run(.sequence([
  .fadeIn(),
  .fadeOut(),
  .parallel([
    .wait(0.5),
    .squeeze()
    .sequence([
      .shake(),
      .log("Has just been shaked")
      .flipX()
    ]),
    .morph()
  ])
]))

Installation

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

pod 'Wave'

Wave is also available through Carthage. To install just write into your Cartfile:

github "onmyway133/Wave"

Author

Khoa Pham, [email protected]

Credit

• https://www.swiftbysundell.com/posts/building-a-declarative-animation-framework-in-swift-part-1

Contributing

We would love you to contribute to Wave, check the CONTRIBUTING file for more info.

License

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

wave's Issues

Protocol extension

Kinda wanted to use protocol extension, but onmyway133/notes#159

Manual Installation

CocoaPods and Carthage are awesome tools and make our life really easier, but there are some devs who still don't know how to use them.

It would be cool to add the Manual installation guide in your README.md. You can take a look at my iOS Readme Template to see how you can do it.

More predefined animations

• change size
• change corner
• explode
• firework

More actions?

• UIKit Dynamic
• Core Text
• Core Graphics
• Replicator layer?
• Shape layer?

Better handling for Wait

For now Wait uses GCD, which does not participate in UIView flow, when user calls the animations multiple time, it should clear the that delay timer

Wanted to use UIView animation with delay, but emptying or animating a view not in window hierarchy makes UIView animation completes right away