How to customize IHProgressHUD colors and themes?

Use methods like setForegroundColor and setBackgroundColor to apply custom colors, which changes the style to custom. Preconfigured light and dark themes are available via set(defaultStyle:), as shown in the Customization section. For dynamic themes, you may need to manually update based on system appearance.

IHProgressHUD vs SVProgressHUD: which is better for Swift?

IHProgressHUD is a Swift port of SVProgressHUD with added thread safety and App Extension support. If you're using Swift and need these features, IHProgressHUD is the better choice. However, for Objective-C projects or simpler needs, SVProgressHUD might suffice with its established ecosystem.

Can I use IHProgressHUD in SwiftUI?

Yes, but it requires bridging since it's a UIKit component. Wrap it in a UIViewRepresentable to integrate into SwiftUI views. The README doesn't provide SwiftUI examples, so you'll need to handle this manually, which can add complexity.

How to add a completion block when dismissing IHProgressHUD?

Use dismissWithCompletion or dismissWithDelay with a completion parameter, as documented in the Dismissing the HUD section. This allows executing code after the HUD hides, useful for chaining tasks or UI updates.

Is IHProgressHUD safe from background threads?

Yes, it's explicitly thread-safe and can be accessed from background threads without issues, as stated in the Thread-Safe Operations feature. This ensures reliable UI updates during concurrent operations like network requests.

Does IHProgressHUD support automatic dark mode?

It has preconfigured light and dark styles, but for automatic adaptation to system dark mode, you need to manually switch styles using set(defaultStyle:) based on trait collections. The README doesn't cover dynamic theme switching out-of-the-box.

Open-Awesome

IHProgressHUD

MITSwift0.1.8

A clean and lightweight progress HUD for iOS and tvOS, ported to Swift from SVProgressHUD with thread safety and App Extension support.

GitHub

280 stars51 forks0 contributors

What is IHProgressHUD?

IHProgressHUD is a Swift port of the popular SVProgressHUD library, providing a clean and lightweight progress indicator for iOS and tvOS apps. It displays task progress with customizable themes, supports haptic feedback, and works safely across threads. The project solves the need for a modern, Swift-native HUD that integrates easily without blocking the user interface.

Target Audience

iOS and tvOS developers who need a reliable, customizable progress indicator for showing task status in their Swift applications, especially those building App Extensions or requiring thread-safe UI updates.

Value Proposition

Developers choose IHProgressHUD because it offers a well-tested, Swift-native alternative to SVProgressHUD with added thread safety, built-in App Extension support, and extensive customization options without requiring Objective-C interoperability.

Overview

A clean and lightweight progress HUD based on SVProgressHUD, converted to Swift with the help of Swiftify.

Use Cases

Best For

Showing progress during network requests or file downloads
Displaying loading states in iOS App Extensions
Providing user feedback for time-consuming background tasks
Implementing customizable progress indicators with haptic feedback
Replacing SVProgressHUD in Swift-based projects
Adding thread-safe HUD controls in multi-threaded iOS apps

Not Ideal For

SwiftUI-only projects that prefer native, declarative UI components
Applications where minimizing third-party dependencies and bundle size is critical
Teams needing highly interactive or non-traditional progress indicators beyond a standard HUD

Pros & Cons

Pros

Thread-Safe Operations

Can be accessed and controlled from background threads safely, preventing UI crashes in multi-threaded environments, as emphasized in the Key Features.

App Extension Support

Works in iOS App Extensions without requiring compiler flags, making it seamless for extension development, as noted in the description and App Extensions section.

Extensive Customization

Offers numerous styling options via methods like setForegroundColor and setBackgroundColor, with preconfigured light/dark themes, detailed in the Customization section.

Built-in Haptic Feedback

Automatically triggers haptic feedback for success, info, and error states on newer iPhones, enhancing user experience, as described in the Haptic Feedback section.

Cons

UIKit Dependency

Built on UIKit, so it doesn't natively support SwiftUI, requiring additional bridging work for modern iOS apps, which isn't addressed in the README.

Complex Customization Setup

With over 20 set methods for styling, achieving specific designs can be verbose and error-prone, and the README lacks detailed examples for advanced use cases.

Limited to Traditional HUD

Designed as a standard progress indicator; for innovative loading animations or interactive elements, developers might need to look elsewhere or build custom solutions.

Frequently Asked Questions

Related Projects

SkeletonView

☠️ An elegant way to show users that something is happening and also prepare them to which contents they are awaiting

Stars12,874

Forks1,126

Last commit1 month ago

SVProgressHUD

A clean and lightweight progress HUD for your iOS and tvOS app.

Stars12,463

Forks2,666

Last commit3 months ago

NVActivityIndicatorView

A collection of awesome loading animations

Stars10,708

Forks1,155

Last commit2 months ago

M13ProgressSuite

A suite containing many tools to display progress information on iOS.

Stars3,908

Forks521

Last commit4 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub