Home

Do follow our blog pages 📃

Loafjet 🚀

About 📒

Loafjet is a light weight Toast(Loaf) generator library which allows the user to add customised Toasts to their projects. Loafjet comes with various types of Toast Animations as well as Toast Positions. It can be used to add gradient and plain toasts. Loafjet comes with extra features like Popup Card and Loading Indicator which can be customised according to your needs.

Now Customise Like Apple  !

Airpods Detection	Silent	Normal

• More Customisation sytles 🎛.

Installation 🌏

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

pod 'Loafjet'

Playground 💻

• I've provided a demo project to showcase the uses of Loafjet! Simply clone this repo, and open Loafjet.xcworkspace.
• Run pod install.
• Here you can see and experiment custom Loaf styles in Examples.swift.

How To Use 📁 ?

From any view controller, a Loaf can be presented by following this two steps:

1. Import Library 🗳

 import Loafjet

2. Call Loafjet 📞

Loaf.PlainLoaf(message: "Message goes here", position: .Bottom, animationDirection: .Bottom, loafjetView: View)

Result: 💯

Plain Default Loaf

• This is the most basic Loafjet that you can make with least line of code 👆.
• Below all Loafjet types are mentioned , have a look on it 😊.

Plain Loaf

* With Default Parameters 📗 

 Loaf.PlainLoaf(message: String, position: loafPosition, animationDirection: loafAnimation, loafjetView: UIView)

* Without Default Parameters 📘

Loaf.PlainLoaf(message: String, position:LoafPosition, loafWidth:CGFloat , loafHeight:CGFloat, cornerRadius: CGFloat, fontStyle: String, fontSize: CGFloat, bgColor: UIColor, fontColor: UIColor, alphaValue:CGFloat, loafImage: String? , animationDirection: LoafAnimation , duration: TimeInterval, loafjetView: UIView)

• Plain Loaf Demo Photo 🌁

Gradient Loaf

* With Default Parameters 📗

Loaf.GradientLoaf(message: String, position: LoafPosition, bgColor1: UIColor, bgColor2: UIColor, fontColor: UIColor, loafImage: String?, animationDirection: loafAnimation, loafjetView: UIView)

* Without Default Parameters 📘

Loaf.GradientLoaf(message: String, position:LoafPosition, loafWidth:CGFloat, loafHeight:CGFloat, cornerRadius: CGFloat, fontStyle: String, fontSize: CGFloat, bgColor1: UIColor, bgColor2: UIColor, fontColor: UIColor, loafImage: String?, animationDirection: LoafAnimation, duration: TimeInterval, loafjetView: UIView)

• Gradient Loaf Demo Photo 🌁

Popup Card

* With Default Parameters 📗

Loaf.PopupCard(message: String, position: LoafPosition, bgColor1: UIColor, bgColor2: UIColor, fontColor: UIColor, loafImage: String?, blurEffect: UIBlurEffectStyle?, loafjetView: UIView)

* Without Default Parameters 📘

Loaf.PopupCard(message: String, position:LoafPosition, loafWidth:CGFloat, loafHeight:CGFloat, cornerRadius: CGFloat, fontStyle: String, fontSize: CGFloat, bgColor1: UIColor, bgColor2: UIColor, fontColor: UIColor, loafImage: String?, duration: TimeInterval, blurEffect: UIBlurEffectStyle?, loafjetView: UIView)

• Popup Card Demo Photo 🌁

Dash Board

* With Default Parameters 📗

Loaf.dashBoard(dashImage: String, dashTitle: String, dashContent: String, dashButtonTitle: String, mainView: UIView)

* Without Default Parameters 📘

Loaf.dashBoard(dashSpacing: CGFloat, dashRadius: CGFloat, dashColor: UIColor, dashImage: String, dashImageRadius: CGFloat, dashTitle: String, dashTitleColor: UIColor, dashContent: String, dashContentColor: UIColor, dashButtonTitle: String, dashButtonTitleColor: UIColor, dashButtonColor: UIColor, dashButtonRadius: CGFloat, dashButtonBorderColor: UIColor, dashButtonBorderWidth: CGFloat, dashDuration: TimeInterval, mainView: UIView)

• Dash Board Demo Photo 🌁

LoafWheel

* With Default Parameters 📗

 Loaf.LoafWheel(message: String, bgColor1: UIColor, bgColor2: UIColor, loafWheelView: UIView)

* Without Default Parameters 📘

Loaf.LoafWheel(message: String, loafWidth:CGFloat, loafHeight:CGFloat, cornerRadius:CGFloat, bgColor1:UIColor, bgColor2:UIColor, fontStyle: String, fontSize: CGFloat, fontColor: UIColor, duration: TimeInterval, wheelStyle: UIActivityIndicatorViewStyle, blurEffect: UIBlurEffectStyle ,loafWheelView: UIView)

• Loafwheel Demo Photo 🌁
• Calling LoafWheel Dismissal is required when LoafWheel is used for Dynamic Processing❕.

LoafWheel Dismissal 📕

Loaf.dismissWheel(loafWheelView:UIView)

Don't want to use CocoaPods❗️

I have a solution 👀

• Add this Loaf.swift file into your project.
• Now you are ready to use Loafjet 🚀.
• Remaining steps are same 😁.
• Do read the documentation till the end to get a reward 🎁 from Loafjet Organisation.

Parameters 🎚

Parameter Definition message Message to show on Loaf position Position of Loaf loafWidth Loaf Width loafHeight Loaf Height cornerRadius CornerRadius of Loaf fontStyle Font Style of Message fontSize Font size of Message bgColor Background Color of Loaf

Parameter Definition alphaValue Opacity value for Loaf's background loafImage Image on Loaf duration Loaf Duration animationDirection Loaf Animation type blurEffect Blur effect type wheelStyle Wheel Style loafWheelView View on which LoafWheel is running loafjetView View on which Loaf is presented

Combination of Position and Animations 📙

• Customise your Loaf according to the below given chart 🎛.

Position & Animation	Left	Right	Top	Bottom
Top	✅	✅	✅	❌
Centre	✅	✅	❌	❌
Bottom	✅	✅	❌	✅

• The above mentioned ❌ means that particular combination of position & animation won't be working accurately .

Snapshots 📸

Plain(Top)	Plain(Bottom)	Plain(Centre)	Plain(Centre)
Gradient(Top)	Gradient(Bottom)	Gradient(Centre)	Gradient(Centre)

• Above shown are few possible ways, you can customise according to your need (Customisation shown below).

Customisation 🛠

• Loafjet offers you a wide variety of customisation, select a style and apply your creativity on it.
• This are some possible ways, "How Loafjet can be used ?".

Snapshots 📷

Do Not Disturb	Information	Warning
Success	Error	Device Detection

Loafjet +

Additional features

• Dash Board,Gradient Loafwheel & Popup card are the additional customisation which you get in Loafjet🥳.

Popup Card	Loaf Wheel

Dash Board

• These are some possible ways of customisation 💡

Loafjet Proprietary	Alert Style	Successful Style

Dark \ Light Mode Support 🔦

Dark Mode	Light Mode

• The above shown are some possible ways, How you can customise?, do try making your own and send it to us here 📲
• What are you waiting for, write pod Loafjet and pod install it .
• Done?, Now enjoy using Loafjet🚀.

Portrait + Landscape Support 🔄

• Loafjet is made with Landscape + Portrait support* 🔓.
• Now You can use your favourite Loaf without taking care of orientation🌀.
• Have a look on your favourite Loafjet supports 📇

Loafjet	Portrait	Landscape
Plain Loaf	✅	✅
Gradient Loaf	✅	✅
Popup Card	✅	✅
Dash Board	✅	❌
Loaf Wheel	✅	✅

• Other than Dash board all the Loafjets support every type of orientation 🎚.
• Dash Board Landscape support will be added soon, stay tuned 💻

Video Demo 🎥

Top(Top)	Bottom(Bottom)

Centre(Right)	Centre(Left)

• These are some possible Position X Animation combination, Loafjet supports various other combinations too.

Instructions ⚠️

• At a time you can only use one Loaf(Simultaneous use is allowed).
• Customise Loaf Position and Anmation according to the above given table.
• Use .greatestFiniteMagnitude in duration to get an infinte loader.
• To dismiss the loader use Loaf.dismissWheel(LoafWheelView:UIView).
• For certain colors and blur effect particular iOS version is required, So to solve it use the below code (By default Xcode will show you both the fix).

// iOS versions will varry 
if #available(iOS 10.0, *) {. 
 // write the code to run
 }
 else {
 print("Error Message")
}

Or

// iOS versions will varry 
 @available(iOS 10.0, *)

• Test Run of few Loafjets are given, have a look on it (Running all Loafjets at a time may lead to irregular functioning!).

Note 🔴

• Currently 'Loafjet' dont support SF Symbols, if you need it just raise an issue and I will try to add it ⚓️.
• The Loafimage you add must be present in the Images.xcassets file .
• Loafimages which you add must be of A x A Size(Else images may get cutout!).
• In the Test Run make sure you don't run all the Loafjets at a time, wait for one whole Loafjet to complete its task, then go for next.
• All the Loafjets are created with default parameters too, so notice carefully which one you are using (Functions with and without default parameters are shown ⬆️).
• Loafjet is still in developement stage, you might face some bugs; do create an issue and inform us☮️.

Author 😊

Gokul Nair

License ⚖️

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

How to Contribute 🖋

• Run the app - Steps are mentioned above.
• If you face issues in any step open a new issue.
• To fix issues: Fork this repository, make your changes and make a Pull Request.

Requirements ❕

• Device running on iOS/iPadOS 12.0+ versions 📱.
• Swift 5.1+ 💻

Community 🍕

• Want to be a part of our Organisation 🚀, then:
• Mail us here ✉️
• Do mention the following things:
  1. Reason
  2. Motive
  3. Skills
  4. What you liked abou Loafjet❤️
  
• We are eager to read you mail⚡️!

Like the Project ?

If you like using any of my projects or like what I'm doing, please consider backing me with appreciating my work: Message me🥰

OR

Drop a star ⭐ if you find this project interesting!

If you ❤️ the project then there is a gift for you:

• Gift From Loafjet Organisation
• Set the following image as your iPhone's Lock Screen wallpaper and see the magic 🪄.
• Thank Me later by giving a ⭐️ to Loafjet🚀 .

Made with ❤️ in 🇮🇳 By Gokul Nair