GitHub/ToastKit

Fork 0

mirror of https://github.com/Desp0o/ToastKit.git synced 2026-05-18 14:30:34 +00:00

Files

T

desp0o 27b9766487 add glass effect

2025-06-17 18:48:59 +04:00

21 KiB

Raw Permalink Blame History

ToastKit

ToastKit is a lightweight and fully customizable Swift package that helps you display informative toast messages in your app. It’s easy to use, supports various built-in toast styles like success, warning, info, error, with icons.... and also allows full customization for your specific needs.

You can quickly use ready-made toasts or create your own custom toast view with complete control over layout, colors, animations, icons, and more.

Features 🚀

Full Customization
Glass Effect
Max Width Support
Custom Icons & SF Symbols
Auto Dismiss
Transition Types
Flexible Layout Direction
Text Styling Options
Shadow Customization
Corner Radius Control
Optional Subtitle
Adaptive Stack Alignment
Smooth Animations
Manual Close Button
Responsive Design

GlassEffect

    VStack {
      
    }
    .frame(maxWidth: .infinity, maxHeight: .infinity)
    //simple usage
    .glassToast(isVisible: $isVisible, title: title)
    
    //with full parameters
    .glassToast(
      isVisible: $isVisible2,
      title: title,
      subtitle: "if you have iOS 26 you can use this toast",
      glassColor: .red.opacity(0.5),
      titleFontColor: .black,
      subtitleFontColor: .black,
      maxWidth: false,
      transitionType: .custom(.asymmetric(insertion: .move(edge: .trailing), removal: .move(edge: .leading)).combined(with: .opacity)),
      animation: .smooth,
      vDirection: .bottom
    )

Configuration ⚙️

Parameter	Type	Default Value	Description
`isVisible`	Binding	—	Binding to control visibility.
`title`	String	—	The main message displayed in the toast.
`subtitle`	String	`""`	Subtitle text for additional info.
`titleFontColor`	Color	`.white`	Font color of the title.
`subtitleFontColor`	Color	`.white`	Font color of the subtitle.
`transitionType`	ToastTransitionType	.move(edge: .top)	The transition animation for how the toast appears/disappears.
`animation`	Animation	.snappy	Animation used to present and dismiss the toast.
`vDirection`	VerticalDirection	.top	Vertical position of the toast (`.top` or `.bottom`).
`maxWidth`	Bool	false	If `true`, toast takes maximum available width.

Success / Warning / Error/ Info - Toasts

simple toast

    VStack {
      
    }
    .frame(maxWidth: .infinity, maxHeight: .infinity)
    .successToast(isVisible: $isVisible, title: "Success")
    .warningToast(isVisible: $isVisible, title: "Warning")
    .errorToast(isVisible: $isVisible, title: "Error")
    .infoToast(isVisible: $isVisible, title: "Info")

with full parameters

    VStack {
      
    }
    .successToast(isVisible: $isVisible, title: "success full width", toastColor: .success, animation: .snappy, titleFontColor: .white, maxWidth: false)
    .warningToast(isVisible: $isVisible, title: "warning full width", toastColor: .warning, animation: .snappy, titleFontColor: .white, maxWidth: false)
    .errorToast(isVisible: $isVisible, title: "error full width", toastColor: .error, animation: .snappy, titleFontColor: .white, maxWidth: false)
    .infoToast(isVisible: $isVisible, title: "info full width", toastColor: .info, animation: .snappy, titleFontColor: .white, maxWidth: false)

Configuration ⚙️

Parameter	Type	Default Value	Description
`isVisible`	Binding	—	Binding to control visibility.
`title`	String	—	The main message displayed in the toast.
`toastColor`	ToastColorTypes	.success / .warning / .error / .info	The visual style or color theme of the toast .
`animation`	Animation	.snappy	Animation used to present and dismiss the toast.
`titleFontColor`	Color	.white	The color of the toast message text.
`maxWidth`	Bool	false	Whether the toast should stretch to the maximum width.

Bottom - Toasts

simple toast

 VStack {
      
    }
    .bottomToast(isVisible: $isVisible, title: "bottom")

with full parameters

 VStack {
      
    }
    .bottomToast(
      isVisible: $isVisible,
      title: "bottom",
      toastColor: .custom(.indigo),
      animation: .bouncy,
      titleFontColor: .white,
      maxWidth: false
    )

Configuration ⚙️

Parameter	Type	Default Value	Description
`isVisible`	Binding	—	Binding to control visibility.
`title`	String	—	The main message displayed in the toast.
`toastColor`	ToastColorTypes	.success	The color type or style of the toast (`.success`, `.error`, `.info`, `.warning`, `.custom(Color)`).
`animation`	Animation	.snappy	Animation used to present and dismiss the toast.
`titleFontColor`	Color	.white	The color of the toast message text.
`maxWidth`	Bool	false	If true, toast stretches to maximum available width.

Edge Slide Toast - Toasts

simple toast

 VStack {
      
    }
    .edgeSlideToast(isVisible: $isVisible, title: "slide")

with full parameters

 VStack {
      
    }
    .edgeSlideToast(
      isVisible: $isVisible,
      title: "slide",
      toastColor: .info,
      animation: .bouncy,
      hDirection: .leading,
      vDirection: .top,
      titleFontColor: .white,
      maxWidth: false
    )

Configuration ⚙️

Parameter	Type	Default Value	Description
`isVisible`	Binding	—	Binding to control visibility.
`title`	String	—	The main message displayed in the toast.
`toastColor`	ToastColorTypes	.success	The color type or style of the toast (`.success`, `.error`, `.info`, `.warning`, `.custom(Color)`).
`animation`	Animation	.snappy	Animation used to present and dismiss the toast.
`hDirection`	HorizontalDirection	.trailing	Slide from horizontal edge (`.leading` or `.trailing`).
`vDirection`	VerticalDirection	.top	Vertical position of the toast (`.top` or `.bottom`).
`titleFontColor`	Color	.white	The color of the toast message text.
`maxWidth`	Bool	false	If `true`, toast stretches to maximum available width.

Toast with SF Symbol

simple toast

 VStack {
      
    }
    .toastWithSFSymbol(
      isVisible: $isVisivble,
      title: "Toast with SF symbol",
      sfSymbolName: "sun.max"
    )

with full parameters

 VStack {
      
    }
    .toastWithSFSymbol(
      isVisible: $isVisivble,
      title: "Toast with SF symbol",
      toastColor: .custom(.indigo),
      titleFontColor: .white,
      sfSymbolName: "sun.max",
      sfSymbolSize: 18,
      sfSymbolColor: .black,
      transitionType: .scale,
      animation: .smooth,
      vDirection: .top,
      maxWidth: false,
      layoutDirection: .leftToRight
    )

Configuration ⚙️

Parameter	Type	Default Value	Description
`isVisible`	Binding	—	Binding to control visibility.
`title`	String	—	The main message displayed in the toast.
`toastColor`	ToastColorTypes	.success	The color type or style of the toast (`.success`, `.error`, `.info`, `.warning`, `.custom(Color)`).
`titleFontColor`	Color	.white	The color of the toast message text.
`sfSymbolName`	String?	nil	Optional name of an SF Symbol.
`sfSymbolSize`	CGFloat?	24	Size of the SF Symbol icon.
`sfSymbolColor`	Color?	.white	Color of the SF Symbol icon.
`transitionType`	ToastTransitionType	.move(edge: .top)	The transition animation for how the toast appears/disappears.
`animation`	Animation	.snappy	Animation used to present and dismiss the toast.
`vDirection`	VerticalDirection	.top	Vertical position of the toast (`.top` or `.bottom`).
`maxWidth`	Bool	false	If `true`, toast takes maximum available width.
`layoutDirection`	LayoutDirection	.leftToRight	Layout direction of content (`.leftToRight` or `.rightToLeft`).

Toast with custom icon or image

simple toast

 VStack {
      
    }
    .toastWithIcon(
      isVisible: $isVisivble,
      title: "with custom icon",
      iconName: "swift"
    )

with full parameters

 VStack {
      
    }
    .toastWithIcon(
      isVisible: $showWithCustomIconToast,
      title: "with custom icon",
      toastColor: .custom(.orange),
      iconName: "swift",
      iconSize: 18,
      iconColor: nil,
      transitionType: .move(edge: .top),
      animation: .bouncy,
      vDirection: .top,
      titleFontColor: .white,
      maxWidth: false,
      layoutDirection: .leftToRight
    )

Configuration ⚙️

Parameter	Type	Default Value	Description
`isVisible`	Binding	—	Binding to control visibility.
`title`	String	—	The main message displayed in the toast.
`toastColor`	ToastColorTypes	.success	The color type or style of the toast (`.success`, `.error`, `.info`, `.warning`, `.custom(Color)`).
`iconName`	String?	nil	Optional name of a custom icon (from asset).
`iconSize`	CGFloat?	24	Size of the custom icon.
`iconColor`	Color?	.white	Color of the custom icon.
`transitionType`	ToastTransitionType	.move(edge: .top)	The transition animation for how the toast appears/disappears.
`animation`	Animation	.snappy	Animation used to present and dismiss the toast.
`vDirection`	VerticalDirection	.top	Vertical position of the toast (`.top` or `.bottom`).
`titleFontColor`	Color	.white	The color of the toast message text.
`maxWidth`	Bool	false	If `true`, toast takes maximum available width.
`layoutDirection`	LayoutDirection	.leftToRight	Layout direction of content (`.leftToRight` or `.rightToLeft`).

🍞 Toast Stack

With ToastStackManager, you can show toasts at the same time!

Certainly, you can utilize toast stacks from your view model. Here’s an example:

// in your ViewModel

import ToastKit
import Combine

final class ViewModel: ObservableObject {
  let toastManager: ToastStackManager
  
  init(toastManager: ToastStackManager = ToastStackManager()) {
    self.toastManager = toastManager
  }
  
  @MainActor func foo() {
    // Your logic
    toastManager.show(title: "foo success toast", toastColor: .success, autoDisappearDuration: 3.0)
    
    // Your logic
    toastManager.show(title: "foo info toast", toastColor: .info)
  }
}

in your view

import ToastKit
import SwiftUI

struct ProfileView: View {
  @StateObject private var vm: ViewModel
  
  init(vm: ViewModel = ViewModel()) {
    _vm = StateObject(wrappedValue: vm)
  }
  
  var body: some View {
    ZStack {
      // Your view
      
      ToastStackView(vm: vm.toastManager)
      // Alternatively, you can utilize it with a custom transition.
      ToastStackView(vm: vm.toastManager, transitionType: .move(edge: .trailing).combined(with: .opacity))
    }
  }
}

ToastStackView Configuration ⚙️

Parameter	Type	Default Value	Description
`title`	String	-	The main message displayed in the toast.
`toastColor`	ToastColorTypes	-	The color type or style of the toast.
`autoDisappearDuration`	TimeInterval	2.0	Duration before toast disappears.

ToastStackManager Configuration ⚙️

Parameter	Type	Default Value	Description
`vm`	ToastStackManager	-	The view model that manages
`transitionType`	AnyTransition	-	Transition animation for appearing/disappearing.

⚠️ Alternatively, you can utilize the `.toast` method to construct a fully customizable toast by specifying the following parameters:

Configuration ⚙️

Parameter	Type	Default Value	Description
`isVisible`	Binding	—	Binding to control visibility.
`title`	String	—	The main toast message.
`toastColor`	ToastColorTypes	`.success`	The color type or style of the toast.
`transitionType`	ToastTransitionType	`.move(edge: .top)`	Transition animation for appearing/disappearing.
`animation`	Animation	`.snappy`	Animation used to show/hide the toast.
`autoDisappear`	Bool	`true`	If `true`, toast disappears automatically.
`autoDisappearDuration`	TimeInterval	`2.0`	Duration before toast disappears.
`maxWidth`	Bool	`false`	If `true`, toast takes maximum width.
`subtitle`	String	`""`	Subtitle text for additional info.
`font`	String	`"SFProDisplay"`	Name of the font used in text.
`titleFontSize`	CGFloat	`16`	Font size of the title.
`titleFontWeight`	Font.Weight	`.semibold`	Font weight of the title.
`titleFontColor`	Color	`.white`	Font color of the title.
`subtitleFontSize`	CGFloat	`14`	Font size of the subtitle.
`subtitleFontWeight`	Font.Weight	`.regular`	Font weight of the subtitle.
`subtitleFontColor`	Color	`.white`	Font color of the subtitle.
`multilineTextAlignment`	TextAlignment	`.center`	Alignment of multiline text.
`innerHpadding`	CGFloat	`20`	Inner horizontal padding.
`innerVpadding`	CGFloat	`10`	Inner vertical padding.
`outterHpadding`	CGFloat	`20`	Outer horizontal padding.
`stackAligment`	Alignment	`.top`	Stack alignment inside the toast.
`isStackMaxHeight`	Bool	`true`	occupies the maximum available height
`cornerRadius`	CGFloat	`12`	Corner radius of the toast.
`shadowColor`	Color	`.black.opacity(0.2)`	Shadow color.
`shadowRadius`	CGFloat	`10`	Radius of the toast's shadow.
`shadowX`	CGFloat	`0`	Horizontal offset of shadow.
`shadowY`	CGFloat	`4`	Vertical offset of shadow.
`withIcon`	Bool	`false`	Whether to show a custom icon.
`iconName`	String?	`nil`	Name of the custom icon.
`iconSize`	CGFloat?	`nil`	Size of the custom icon.
`iconColor`	Color?	`nil`	Color of the custom icon.
`withSfsymbol`	Bool	`false`	Whether to show an SF Symbol.
`sfSymbolName`	String?	`nil`	Name of the SF Symbol.
`sfSymbolSize`	CGFloat?	`nil`	Size of the SF Symbol.
`sfSymbolColor`	Color?	`nil`	Color of the SF Symbol.
`layoutDirection`	LayoutDirection	`.leftToRight`	Layout direction of content.
`closeSFicon`	String	`"x.circle"`	SF Symbol used as close button.
`closeSFiconSize`	CGFloat	`18`	Size of the close icon.
`closeSFiconColor`	Color	`.white`	Color of the close icon.

Installation via Swift Package Manager 🖥️

Open your project.
Go to File → Add Package Dependencies.
Enter URL: https://github.com/Desp0o/ToastKit.git
Click Add Package.

Contact 📬

Email: tornike.despotashvili@gmail.com
LinkedIn: https://www.linkedin.com/in/tornike-despotashvili-250150219/
github: https://github.com/Desp0o

21 KiB Raw Permalink Blame History Unescape Escape

ToastKit

Features 🚀

GlassEffect

Configuration ⚙️

Success / Warning / Error/ Info - Toasts

simple toast

with full parameters

Configuration ⚙️

Bottom - Toasts

simple toast

with full parameters

Configuration ⚙️

Edge Slide Toast - Toasts

simple toast

with full parameters

Configuration ⚙️

Toast with SF Symbol

simple toast

with full parameters

Configuration ⚙️

Toast with custom icon or image

simple toast

with full parameters

Configuration ⚙️

🍞 Toast Stack

With ToastStackManager, you can show toasts at the same time!

Certainly, you can utilize toast stacks from your view model. Here’s an example:

in your view

ToastStackView Configuration ⚙️

ToastStackManager Configuration ⚙️

⚠️ Alternatively, you can utilize the .toast method to construct a fully customizable toast by specifying the following parameters:

Configuration ⚙️

Installation via Swift Package Manager 🖥️

Contact 📬

21 KiB

Raw Permalink Blame History

⚠️ Alternatively, you can utilize the `.toast` method to construct a fully customizable toast by specifying the following parameters: