How do I create a draggable bottom sheet with PopupView?

Enable dragToDismiss on a bottom-positioned toast type, as shown in the README example. You'll need to provide your own card content view, and the library handles the drag gesture for dismissals.

PopupView vs SwiftUI's built-in .alert: which should I use?

Use PopupView for highly customizable, animated overlays like toasts or complex sheets, while SwiftUI's .alert is better for simple, system-standard dialog boxes with limited styling options. PopupView offers more flexibility but adds a dependency.

Can PopupView show multiple popups at the same time?

Yes, depending on the display mode. Overlay and UIWindow modes support multiple stacked popups, but sheet mode does not, as indicated in the comparison table in the README.

How does PopupView handle keyboard appearances?

It offers a useKeyboardSafeArea parameter that, when enabled, adjusts the popup position to avoid keyboard overlap, ensuring content remains visible during text input.

Is PopupView compatible with iOS 14 or older versions?

No, PopupView requires iOS 15.0+ along with macOS 11.0+, tvOS 14.0+, and watchOS 7.0+, making it unsuitable for apps supporting earlier OS versions.

How to dismiss a popup programmatically in PopupView?

Control dismissal via the isPresented binding passed to the .popup modifier. Setting this binding to false will hide the popup, and you can use autohideIn or dismissCallback for timed or callback-based dismissals.

Open-Awesome

PopupView

MITSwift

A SwiftUI library for displaying customizable toasts, popups, alerts, and sheets with multiple presentation modes.

GitHub

4.0k stars310 forks0 contributors

What is PopupView?

PopupView is a SwiftUI library for creating and managing transient UI components such as toasts, popups, alerts, and sheets. It solves the problem of implementing consistent, animated overlays across iOS, macOS, tvOS, and watchOS apps with a declarative and highly customizable API.

Target Audience

SwiftUI developers building iOS, macOS, tvOS, or watchOS applications who need to display temporary notifications, alerts, or modal content with polished animations and interactions.

Value Proposition

Developers choose PopupView for its extensive customization options, multiple presentation modes (overlay, sheet, window), and seamless integration with SwiftUI's state management, making it a robust alternative to building custom overlay solutions from scratch.

Overview

Toasts and popups library written with SwiftUI

Use Cases

Best For

Displaying toast notifications in SwiftUI apps
Creating custom alert dialogs with unique animations
Implementing draggable bottom sheets for iOS
Showing temporary floating messages or banners
Building onboarding flows with animated popups
Adding interactive tooltips or hints in user interfaces

Not Ideal For

Apps targeting iOS 14 or earlier, as PopupView requires iOS 15.0+
Projects deeply integrated with UIKit where introducing SwiftUI popups could conflict with existing navigation systems
Teams seeking pre-styled, out-of-the-box popup components without any SwiftUI view customization

Pros & Cons

Pros

Versatile Popup Types

Supports default, toast, floater, and scrollable sheet types with distinct behaviors, enabling everything from simple notifications to interactive draggable cards.

Flexible Display Modes

Offers three presentation options—overlay, sheet, and UIWindow-based—each with specific advantages for stacking, tapping through backgrounds, or showing over navigation bars, as detailed in the comparison table.

Rich Animation Control

Includes slide, scale, and zoom animations with separate appear and disappear directions, allowing for polished, custom transitions beyond basic fades.

Declarative SwiftUI API

Uses a modifier with a customizable closure for intuitive setup, making parameter ordering flexible and integration with SwiftUI's state management seamless in most modes.

Cons

UIWindow State Quirks

In UIWindow display mode, SwiftUI's @State doesn't update properly, forcing developers to use ObservableObjects or @Bindings instead, as highlighted in the README's workaround example.

Frequent Breaking Changes

Major versions like 3 and 4 introduced breaking API changes, such as renaming enums and deprecating parameters, which can disrupt maintenance and require code updates.

Limited Package Manager Support

Cocoapods is deprecated after version 4.0.0, leaving Swift Package Manager as the primary option, which may not fit all project workflows or legacy setups.

Frequently Asked Questions

Related Projects

SwiftMessages

A very flexible message bar for UIKit and SwiftUI.

Stars7,557

Forks766

Last commit2 months ago

SwiftEntryKit

SwiftEntryKit is a presentation library for iOS. It can be used to easily display overlays within your iOS apps.

Stars6,757

Forks622

Last commit1 year ago

Alerts & Pickers

Advanced usage of UIAlertController and pickers based on it: Telegram, Contacts, Location, PhotoLibrary, Country, Phone Code, Currency, Date...

Stars5,763

Forks710

Last commit2 years ago

SCLAlertView-Swift

Beautiful animated Alert View. Written in Swift

Stars5,321

Forks753