https://github.com/pedrommcarrasco/fluky
๐ฒ Loading based on random icons
https://github.com/pedrommcarrasco/fluky
animation cocoapods icons loading random-generation
Last synced: about 1 year ago
JSON representation
๐ฒ Loading based on random icons
- Host: GitHub
- URL: https://github.com/pedrommcarrasco/fluky
- Owner: pedrommcarrasco
- License: mit
- Created: 2018-10-22T12:05:24.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-10-05T14:34:29.000Z (over 6 years ago)
- Last Synced: 2025-03-24T12:47:31.755Z (about 1 year ago)
- Topics: animation, cocoapods, icons, loading, random-generation
- Language: Swift
- Homepage:
- Size: 3.49 MB
- Stars: 136
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
> **Fluky** *(/หfluหki/)*, *adjective*
>
> "obtained or achieved more by chance than skill"
Make every loading screen different with Fluky, your random loading screen inspired by PlayStation.
[](https://cocoapods.org/pods/Fluky)
[](https://github.com/Carthage/Carthage)
[](https://github.com/pedrommcarrasco/Fluky/blob/master/LICENSE)
## Installation ๐ฆ
### Cocoapods
Fluky is available through [CocoaPods](https://cocoapods.org/pods/Fluky). To do so, add the following line to your PodFile:
```swift
pod 'Fluky'
```
And then run the following command in terminal:
```swift
pod install
```
### Carthage
Add this to your Cartfile:
```swift
github "pedrommcarrasco/Fluky"
```
And then run the following command in terminal:
```swift
carthage update
```
### Swift Package Manager
In your app target click `+` in `Frameworks, Libraries, and Embedded Content`, then `Add Other...`, `Add Package Dependency...`, put repository url `https://github.com/pedrommcarrasco/Fluky.git`
## Styles ๐
| Single | Linear | Box |
| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
|  |  |  |
* โ๏ธ *This background is not part of Fluky*
## Usage Example โจ๏ธ
After installing Fluky, you should start by importing the framework:
```swift
import Fluky
```
Once imported, you can start using Fluky to create randomized icon based loading sceens. Bellow, you'll be able to see a working example. First, we start by creating a `FlukyView`:
```swift
let flukyView = Fluky.view(as: .single, with: images) // images -> array of icons you want to display
// size has a default parameter of 30.0
```
Once you apply your constraints, to start animating you just need to do:
```swift
flukyView.start()
```
In order to stop you just do:
```swift
flukyView.stop()
```
With the goal of being as customizable as possible, Fluky only creates a `FlukyView` responsible for managing the icons and its animations. With this in mind, it should be added to your view hierarchy where you can customize `backgroundColor`, add a `UILabel` & others.
## Sample Project ๐ฒ
There's a sample project in this repository called [Example](https://github.com/pedrommcarrasco/Fluky/tree/master/Example) with some examples.
## Support Fluky โค๏ธ
Hello there ๐
Iโm Pedro, a Portuguese iOS Engineer since February 2017. Iโm an avid OSS enthusiast and contributor - help by sharing, learn by whatโs shared.
I've built and open-sourced multiple frameworks and applications, including **[Brooklyn](https://github.com/pedrommcarrasco/Brooklyn)** and **[CocoaHub](https://cocoahub.app)**.
I'm also a conference and meetup organizer, being part of **[SwiftAveiro](https://swiftaveiro.xyz)** and **[CocoaHeads Porto](https://www.meetup.com/CocoaHeads-Porto/)**.
If you enjoy my work and would like to help me continue it, please consider:
* https://github.com/users/pedrommcarrasco/sponsorship
* https://www.buymeacoffee.com/pedrommcarrasco
* https://www.paypal.me/pedrommcarrasco
## Contributing ๐
Feel free to contribute to this project by providing [ideas](https://github.com/pedrommcarrasco/Fluky/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc) or opening [pull requests](https://github.com/pedrommcarrasco/Fluky/pulls?q=is%3Apr+is%3Aopen+sort%3Aupdated-desc).
## License โ
Fluky's available under the MIT license. See the [LICENSE](https://github.com/pedrommcarrasco/Fluky/blob/master/LICENSE) file for more information.