# Confetti Animation in SwiftUI

The open-source Swift package [`ConfettiSwiftUI`](https://github.com/simibac/ConfettiSwiftUI) lets you to create and customize confetti animations built with SwiftUI.

![Default Animation](https://cdn.hashnode.com/res/hashnode/image/upload/v1651572861671/o-Qv3iFLm.gif align="left")

I am impressed by its **ease of use** and **rich customization options**.

You need to write three lines of code to apply a beautiful confetti animation for your SwiftUI view.

```Swift
import ConfettiSwiftUI // 1. import package
import SwiftUI

struct ContentView: View {
    
    @State private var counter: Int = 0 // 2. define state variable
    
    var body: some View {
        Button("🎉") {
            counter += 1
        }
        .confettiCannon(counter: $counter) // 3. done => magic :)
    }
}
```

You can trigger a new animation by changing an integer-based state variable. The ViewBuilder function `.confettiCannon`, an extension on `View`, does the rest.

A variety of function parameters allows you to configure the confetti animation, e.g. you can change the
- amount of confetti
- shapes and text
- colors applied to the default shapes
- radius and angles of the explosion
- explosion repetition
- duration between explosion repetitions

Probably my favorite option is to use emojis as text.

```Swift
.confettiCannon(counter: $counter, num:1, confettis: [.text("💵"), .text("💶"), .text("💷"), .text("💴")], confettiSize: 30, repetitions: 50, repetitionInterval: 0.1)
```
![makeItRain.gif](https://cdn.hashnode.com/res/hashnode/image/upload/v1651572471740/N4aSmIomI.gif align="left")

`ConfettiSwiftUI` is a lovely, cross-platform utility package with no additional dependencies.

```swift
platforms: [
    .iOS(.v14),
    .macOS(.v11),
    .tvOS(.v14),
    .watchOS(.v7)
]
```

I recommend to explore the [Demo App](https://github.com/simibac/ConfettiSwiftUIDemo) to make your desired animation or get inspired by one of the many examples.