How do I chain multiple animations together in Wave?

Use the .sequence() method for sequential animations or .parallel() for concurrent ones. For example, view.run(.sequence([.fadeIn(), .fadeOut()])) runs animations in order, as demonstrated in the README code snippet.

Is Wave better than using UIView.animate for simple animations?

For simple, single animations, UIView.animate is more straightforward and lightweight. Wave shines when you need complex sequences or parallels, offering better readability and maintainability for multi-step workflows.

Does Wave work with SwiftUI?

No, Wave is designed for UIKit and Core Animation. It doesn't natively support SwiftUI animations, so you'd need to use UIViewRepresentable or similar bridges, or consider SwiftUI-native animation frameworks instead.

How can I create a custom animation type in Wave?

Wave is extensible; you can define custom animations by conforming to the animation protocols. Check the source code or contributing guidelines for details on extending the framework with new behaviors.

What are the performance implications of using Wave?

Wave builds on top of Core Animation, so performance is generally good for UI animations. However, the abstraction layer might add minimal overhead compared to direct Core Animation calls, but it's negligible for most use cases.

Are there any examples of complex animations using Wave?

The README includes a GIF and a code snippet demonstrating sequence and parallel animations. For more examples, you might need to explore the GitHub repository, community contributions, or the author's other apps for inspiration.

Open-Awesome

Wave

NOASSERTIONSwift

A declarative chainable animation framework for Swift, supporting sequential and parallel animations.

GitHub

128 stars9 forks0 contributors

What is Wave?

Wave is a declarative animation framework for Swift that allows developers to create complex animations using a chainable syntax. It solves the problem of managing intricate animation sequences by providing a readable way to compose sequential and parallel animations for iOS and macOS apps.

Target Audience

iOS and macOS developers who need to implement complex, multi-step animations in their Swift applications, particularly those working with UIKit or Core Animation.

Value Proposition

Developers choose Wave for its declarative, chainable syntax that makes complex animation sequences more readable and maintainable compared to traditional imperative animation code, while supporting both UIView and Core Animation.

Overview

:ocean: Declarative chainable animations in Swift

Use Cases

Best For

Creating complex multi-step animation sequences in iOS apps
Building declarative animation logic for SwiftUI or UIKit interfaces
Implementing parallel animations with precise timing control
Extending animation capabilities with custom animation types
Simplifying animation code in Swift projects
Managing chained animations for interactive user interfaces

Not Ideal For

Apps built entirely with SwiftUI that rely on native animation modifiers
Projects with only simple, single-step animations where UIView.animate is sufficient
Teams requiring real-time, performance-critical animations like in games, where direct Core Animation manipulation is preferred

Pros & Cons

Pros

Declarative Readability

The framework uses a clear syntax like .sequence([...]) and .parallel([...]), as shown in the README example, making complex animation flows easier to understand and maintain compared to imperative code.

Flexible Animation Composition

Allows chaining sequences and parallels, enabling precise control over timing and order of multiple animations, which simplifies creating intricate animation workflows.

Dual API Support

Compatible with both high-level UIView animations and lower-level Core Animation, providing flexibility for different use cases without locking into a single approach.

Extensible Architecture

Built to be extended with custom animation types, as mentioned in the features, allowing developers to add new behaviors and tailor the framework to specific needs.

Cons

Limited SwiftUI Integration

The framework is built for UIView and Core Animation, with no evident support for SwiftUI's native animation system, making it less suitable for modern SwiftUI-based apps.

Sparse Documentation

The README provides only a basic usage example without comprehensive API documentation or tutorials, which could hinder adoption and troubleshooting for complex scenarios.

Dependency Overhead

Adding Wave as a dependency introduces external code that might conflict with other libraries or require updates, compared to using built-in Apple frameworks with less maintenance risk.

Frequently Asked Questions

Related Projects

Lottie

An iOS library to natively render After Effects vector animations

Stars26,802

Forks3,833

Last commit16 days ago

ViewAnimator

ViewAnimator brings your UI to life with just one line

Stars7,311

Forks486

Last commit2 years ago

AnimatedCollectionViewLayout

A UICollectionViewLayout subclass that adds custom transitions/animations to the UICollectionView without effecting your existing code.

Stars4,854

Forks346

Last commit5 years ago

Advance

Physics-based animations for iOS, tvOS, and macOS.

Stars4,466

Forks204

Last commit4 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub