Konfetti

<!-- LOGO -->
<br />
<h1>
<p align="center">
  <img src="https://user-images.githubusercontent.com/1636897/147644327-112cc446-75ea-4477-80ac-1d0cd60fc45e.png" alt="Logo">
</h1>
<p align="center">
    Easily celebrate little and big moments in your app with this lightweight confetti library!
    <br />
</p>

<p align="center">
    <a href="https://opensource.org/licenses/ISC"><img alt="License" src="https://img.shields.io/badge/License-ISC-yellow.svg"/></a>
    <a href="https://android-arsenal.com/api?level=15"><img alt="API level 15" src="https://img.shields.io/badge/API-15%2B-brightgreen.svg?style=flat"/></a>
    <a href="http://twitter.com/dionsegijn"><img alt="Twitter" src="https://img.shields.io/badge/Twitter-@dionsegijn-blue.svg?style=flat"/></a>
    <a href="https://github.com/DanielMartinus/Konfetti/actions"><img alt="Build Status" src="https://github.com/DanielMartinus/Konfetti/workflows/CI/badge.svg"/></a>
</p>

<p align="center">
  <a href="#getting-started">Getting started</a> •
  <a href="#usage">How To Use</a> •
  <a href="#community">Community</a> •
  <a href="#contribute">Contribute</a> •
  <a href="#report-an-issue">Report issue</a> •
  <a href="#license">License</a>
</p>

<p align="center">
  <strong>New version: 2.0.0 is now released! Jetpack compose support - improved animations and API - <a href="https://dionsegijn.dev/konfetti-migration-guide-v2.x.x">see migration guide here</a></strong>
</p>

## Getting started

Compose project (min API 21):
```groovy
dependencies {
    implementation 'nl.dionsegijn:konfetti-compose:2.2.0'
}
```

View based (XML) project (min API 15):
```groovy
dependencies {
    implementation 'nl.dionsegijn:konfetti-xml:2.2.0'
}
```

Both pull in `konfetti-core` and `konfetti-image` automatically. Core is plain Kotlin without Android, so you can also use it on its own to build your own renderer.

Find latest version and release notes [here](https://github.com/DanielMartinus/Konfetti/releases)

## Usage

<p align="center">
  <strong>Samples:</strong></br>
  <a href="/samples/compose-kotlin/src/main">compose</a> •
  <a href="/samples/xml-kotlin/src/main">xml-kotlin</a> •
  <a href="/samples/xml-java/src/main">xml-java</a> •
  <a href="/samples/shared/src/main/java/nl/dionsegijn/samples/shared/Presets.kt">presets</a>
</p>  

<p align="center">
  <img width=300 src="https://user-images.githubusercontent.com/1636897/147699597-2d177073-a2f8-4f49-ad7e-c390dd374557.gif"/>
</p>

Configure your confetti using the Party configuration object. This holds all the information on how the confetti will be generated.
Almost all properties of a Party object have a default configuration! This makes it super easy to create beautiful and natural looking confetti.


The bare minimum you need is an **Emitter** to tell how often and how many confetti should spawn, like this:
```kotlin
Party(
    emitter = Emitter(duration = 5, TimeUnit.SECONDS).perSecond(30)
)
```

**But the possibilities are endless!** You can fully control how t