MBToastMac

MBToastMac: Toasts for macOS. Crafted in Swift.

In the world of macOS development, clarity and brevity are often the keys to effective user interaction. MBToast was forged with this philosophy in mind.

We understand that every interaction, no matter how brief, is a touchpoint between the user and the software. It’s a chance to inform, to guide, to reassure. That’s why we developed a toast system that's not just about fleeting messages but about enriching those small moments of communication.

Why choose MBToast?

Simplicity: Our library integrates seamlessly into your macOS projects, allowing you to implement toasts without the weight of unnecessary features.

Efficiency: Built with Swift, it's optimized for performance, ensuring your app remains agile and responsive.

Customizability: While we value minimalism, we also understand the importance of adaptability. Customize to fit your application's aesthetics, ensuring consistency in design.

Reliability: Every toast delivered is a result of rigorous testing and refinement, ensuring reliability in varied use-cases.

Dive into MBToast – where minimalism meets function. Elevate your user feedback and make every message count.

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Basic Usage

1. Displaying a Custom Toast Message

To show a basic toast message with a custom style:

self.view.makeToast("Your Message Here")

2. Displaying Predefined Toast Styles

• Success Toast

self.view.makeToast("Your Message Here", style: MBToastStyleSuccess())

• Warning Toast

self.view.makeToast("Your Message Here", style: MBToastStyleWarning())

• Info Toast

self.view.makeToast("Your Message Here", style: MBToastStyleInfo())

3. Displaying Progress Toast

Utilize the overlay progress indicator for instances where the duration is indeterminate. This feature ensures users are informed during periods of background activity or while awaiting a response.

• Start Progress

self.view.makeToastActivity()

• Stop Progress

self.view.hideToastActivity()

Customization

You have the ability to fully customize the appearance and behavior of the toast notifications by conforming to the Style protocol. This protocol provides a wide range of properties to adjust, such as font size, margin adjustments, color specifications, and more. By conforming to this protocol, you can tailor the toast appearance to better fit your application's theme and design philosophy.

Style Protocol Properties:

Property	Description
fontSize	Font size of the message.
horizontalMargin	Horizontal margin for the toast.
verticalMargin	Vertical margin for the toast.
cornerRadius	Corner radius of the toast.
font	Font of the message.
backgroundColor	Background color of the toast.
foregroundColor	Text color of the message.
fadeInOutDuration	Duration of the fade in/out animations.
fadeInOutDelay	Delay before the fade out begins.
labelOriginWithMargin	Origin point of the message label with margins.
activitySize	Size of the progress indicator.
position	Position of the toast on the screen.
icon	Optional icon image. Default is nil.

Custom Style Example:

To create your custom style, you can implement the Style protocol like the following:

struct CustomToastStyle: Style {
    var fontSize: CGFloat = 14.0
    var fontSize: CGFloat = 14.0
    var horizontalMargin: CGFloat = 15.0
    var verticalMargin: CGFloat = 10.0
    var cornerRadius: CGFloat = 5.0
    var font: NSFont = NSFont.systemFont(ofSize: 14.0)
    var backgroundColor: NSColor = NSColor.black.withAlphaComponent(0.7)
    var foregroundColor: NSColor = NSColor.white
    var fadeInOutDuration: CGFloat = 0.3
    var fadeInOutDelay: CGFloat = 2.0
    var labelOriginWithMargin: CGPoint = CGPoint(x: 15.0, y: 10.0)
    var activitySize: CGSize = CGSize(width: 50, height: 50)
    var position: MBToastPosition = .bottom
    var icon: NSImage? = nil
    var iconTint: NSColor = NSColor.white
}

// Usage:
self.view.makeToast("Custom styled toast", style: CustomToastStyle())

Installation

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

pod 'MBToastMac'

You may also opt to download the project and integrate the MBToastMac directory into your existing project for a more streamlined approach.

Author

Viorel Porumbescu
📧 viorelporumbescu@outlook.com
📄 Resume

License

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