How do I add a progress bar to a status bar notification in iOS?

Use the displayProgressBar method or SwiftUI bindings to show progress, as shown in the examples with animated progress bars and manual percentage setting.

JDStatusBarNotification vs MBProgressHUD for iOS?

JDStatusBarNotification is better for customizable, interactive notifications below the status bar, while MBProgressHUD is more suited for full-screen loading indicators. Choose based on design and placement needs.

How to customize notification colors in JDStatusBarNotification?

Modify the StatusBarNotificationStyle using the updateDefaultStyle closure or style editor, allowing changes to background colors, text colors, and more, as detailed in the customization section.

Does JDStatusBarNotification work with SwiftUI?

Yes, it fully supports SwiftUI with a .notification modifier for state-driven presentation and custom view integration, as shown in the getting started examples.

Why is my JDStatusBarNotification not showing up?

This often occurs due to failed automatic window scene detection in apps with UIWindowScene. Manually set the scene using NotificationPresenter.shared.setWindowScene(windowScene), as mentioned in troubleshooting.

How to use custom SwiftUI views in notifications?

Use the presentSwiftView method or .notification modifier with a view builder to embed custom SwiftUI content, enabling full control over the notification's appearance.

Open-Awesome

JDStatusBarNotification

MITSwift2.2.0

A highly customizable iOS status bar notification library with interactive dismiss, custom views, and SwiftUI support.

Visit Website GitHub

4.3k stars564 forks0 contributors

What is JDStatusBarNotification?

JDStatusBarNotification is an iOS library for displaying highly customizable notifications below the status bar, notch, or Dynamic Island. It solves the need for flexible, interactive notification systems in iOS apps, offering features like drag-to-dismiss, custom views, and built-in components like progress bars and activity indicators. The library supports both SwiftUI and UIKit, with full compatibility for Objective-C projects.

Target Audience

iOS developers building apps that require customizable, interactive notifications, especially those using SwiftUI or needing cross-compatibility with Objective-C.

Value Proposition

Developers choose JDStatusBarNotification for its extensive customization options, interactive features like drag-to-dismiss, and seamless integration with both SwiftUI and UIKit. Its adaptability to different device layouts and support for custom views make it a versatile alternative to basic system notifications.

Overview

Highly customizable & feature rich notifications. Interactive dismiss. Custom Views. SwiftUI. Tap-to-hold. Progress. Written in Swift, compatible for ObjC!

Use Cases

Best For

Adding interactive, dismissible notifications to iOS apps
Displaying custom SwiftUI or UIView content in status bar notifications
Showing progress or activity indicators in notifications
Creating adaptive notifications for devices with notches or Dynamic Islands
Building iOS apps with both Swift and Objective-C compatibility
Implementing highly stylized notification systems with custom animations

Not Ideal For

Cross-platform apps requiring notifications on Android or web
Projects needing out-of-the-box, pre-styled notifications with zero configuration
Apps with complex multi-window or multi-scene architectures where automatic window detection might fail

Pros & Cons

Pros

Extensive Customization Options

Supports fully customizable colors, fonts, animations, and layouts (pill or full-width), with a built-in style editor for live tweaking, as shown in the customization section.

Seamless SwiftUI Integration

Offers state-driven presentation via a .notification modifier in SwiftUI, enabling easy integration with modern iOS apps, as demonstrated in the getting started examples.

Interactive Dismiss Gestures

Includes drag-to-dismiss functionality, enhancing user experience with intuitive notification control, evidenced by GIFs in the README.

Objective-C Compatibility

Full API available for Objective-C projects, making it versatile for mixed or legacy codebases, as stated in the installation and examples.

Cons

Window Scene Detection Issues

In apps using UIWindowScene, automatic detection can fail silently, requiring manual setup with setWindowScene(), which adds complexity and potential for bugs.

Steep Customization Learning Curve

While powerful, the style API has numerous options (e.g., StatusBarNotificationStyle), which can be overwhelming for simple use cases without using the style editor.

Limited Built-in Notification Types

Focuses on status bar area notifications only, lacking support for other common notification styles like banners or alerts that appear elsewhere on screen.

Frequently Asked Questions

Related Projects

SwiftMessages

A very flexible message bar for UIKit and SwiftUI.

Stars7,553

Forks764

Last commit5 months ago

Alerts & Pickers

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

Stars5,759

Forks702

Last commit2 years ago

BulletinBoard

General-purpose contextual cards for iOS

Stars5,342

Forks301

Last commit4 years ago

SCLAlertView-Swift

Beautiful animated Alert View. Written in Swift

Stars5,312

Forks751