Customizable Swift Toast view built with UIKit. 🍞

What's New

v2.1.2: Automatically close overlapped toasts


What's Changed

  • feat: add option to close overlapped toasts by @jisu15-kim in #51
  • Added check for show with haptics method to not compile for visionOS by @SwapnanilDhol in #53

New Contributors

Full Changelog: 2.1.1...2.1.2


Codacy Badge

A Swift Toast view - iOS 14 style - built with UIKit. 🍞


Swift Package Manager

You can use The Swift Package Manager to install Toast-Swift by adding the description to your Package.swift file:

dependencies: [
    .package(url: "", from: "2.1.2")


pod "ToastViewSwift"


To create a simple text based toast:

let toast = Toast.text("Safari pasted from Notes")

Or add a subtitle:

let toast = Toast.text("Safari pasted from Notes", subtitle: "A few seconds ago")

And if you want to use your own font(NSAttributedString is supported):

let attributes = [
    NSAttributedStringKey.font: UIFont(name: "HelveticaNeue-Bold", size: 17)!, 
let attributedString  = NSMutableAttributedString(string: "Safari pasted from Notes" , attributes: attributes)
let toast = Toast.text(attributedString)

If you want to add an icon, use the default method to construct a toast:

let toast = Toast.default(
    image: UIImage(systemName: "airpodspro")!,
    title: "Airpods Pro",
    subtitle: "Connected"

Want to use a different layout, but still use the Apple style? Create your own view and inject it into the AppleToastView class when creating a custom toast:

let customView: UIView = // Custom view

let appleToastView = AppleToastView(child: customView)

let toast = Toast.custom(view: appleToastView)

The show method accepts several optional parameters. haptic of type UINotificationFeedbackGenerator.FeedbackType to use haptics and after of type TimeInterval to show the toast after a certain amount of time: .success, after: 1)

Configuration options

The text, default and custom methods support custom configuration options. The following options are available:

Name Description Type Default
direction Where the toast will be shown. .bottom or .up .up
dismissBy Choose when the toast dismisses. Dismissable [.time, .swipe]
animationTime Duration of the show and close animation in seconds. TimeInterval 0.2
enteringAnimation The type of animation that will be used when toast is showing .slide, .fade, .scaleAndSlide, .scale and .custom .default
exitingAnimation The type of animation that will be used when toast is exiting .slide, .fade, .scaleAndSlide, .scale and .custom .default
attachTo The view which the toast view will be attached to. UIView nil
let config = ToastConfiguration(
    direction: .top,
    dismissBy: [.time(time: 4.0), .swipe(direction: .natural), .longPress],
    animationTime: 0.2

let toast = toast.text("Safari pasted from Notes", config: config)

Custom entering/exiting animations

self.toast = Toast.text(
            "Safari pasted from Noted",
            config: .init(
                direction: .bottom,
                enteringAnimation: .fade(alphaValue: 0.5),
                exitingAnimation: .slide(x: 0, y: 100))

The above configuration will show a toast that will appear on screen with an animation of fade-in. And then when exiting will go down and disapear.

self.toast = Toast.text(
            "Safari pasted from Noted",
            config: .init(
                direction: .bottom,
                enteringAnimation: .scale(scaleX: 0.6, scaleY: 0.6),
                exitingAnimation: .default

The above configuration will show a toast that will appear on screen with scaling up animation from 0.6 to 1.0. And then when exiting will use our default animation (which is scaleAndSlide)

For more on animation see the Toast.AnimationType enum.

Custom toast view

Don't like the default Apple'ish style? No problem, it is also possible to use a custom toast view with the custom method. Firstly, create a class that confirms to the ToastView protocol:

class CustomToastView : UIView, ToastView {
    private let text: String

    public init(text: String) {
        self.text = text

    func createView(for toast: Toast) {
        // View is added to superview, create and style layout and add constraints

Use your custom view with the custom construct method on Toast:

let customToastView: ToastView = CustomToastView(text: "Safari pasted from Notes")

let toast = Toast.custom(view: customToastView)


To show toasts after each other, use the ToastQueue class:

let toast1 = Toast.text("Notification 1")
let toast2 = Toast.text("Notification 2")
let toast3 = Toast.text("Notification 3")

let queue = ToastQueue([toast1, toast2, toast3])


Below delegate functions are optional to implement when implementing ToastDelegate.

extension MyViewController: ToastDelegate {
    func willShowToast(_ toast: Toast) {
        print("Toast will be shown after this")

    func didShowToast(_ toast: Toast) {
        print("Toast was shown")

    func willCloseToast(_ toast: Toast) {
        print("Toast will be closed after this")

    func didCloseToast(_ toast: Toast) {
        print("Toast was closed (either automatically, dismissed by user or programmatically)")


Toast-Swift is available under the MIT licence. See the LICENCE for more info.

Stargazers repo roster for @BastiaanJansen/Toast-Swift


  • Swift Tools 5.3.0
View More Packages from this Author


  • None
Last updated: Fri Mar 01 2024 09:42:59 GMT-1000 (Hawaii-Aleutian Standard Time)