How do I change the color of SVProgressHUD?

Use the setForegroundColor: and setBackgroundColor: methods to customize colors. This automatically sets the style to SVProgressHUDStyleCustom, overriding preset styles for full control.

SVProgressHUD vs MBProgressHUD: which is better?

SVProgressHUD is often preferred for its cleaner design, haptic feedback, and active maintenance, while MBProgressHUD is older but more established. Choose SVProgressHUD for modern apps needing customization.

How to use SVProgressHUD in a Swift project?

Import the module and call methods like SVProgressHUD.show(). If using CocoaPods, add use_frameworks! to your Podfile; for manual setup, use a bridging header to include the Objective-C code.

Can SVProgressHUD work with SwiftUI?

Yes, but it requires bridging since it's UIKit-based. Wrap it in a UIViewRepresentable to integrate into SwiftUI views, which adds extra boilerplate code compared to native SwiftUI solutions.

How to add haptic feedback to SVProgressHUD?

Enable haptics by calling setHapticsEnabled: true. It automatically maps success, error, and info states to appropriate UINotificationFeedbackType on supported iPhones, no additional setup needed.

What's the best way to dismiss SVProgressHUD after a task?

Use dismissWithDelay: for timed dismissal or balance show calls with popActivity. For async tasks, always dismiss on the main thread to avoid UI glitches, as shown in the README examples.

Open-Awesome

SVProgressHUD

MITObjective-C

A clean and lightweight progress HUD for iOS and tvOS apps to display task progress.

Visit Website GitHub

12.5k stars2.7k forks0 contributors

What is SVProgressHUD?

SVProgressHUD is a lightweight and customizable progress indicator library for iOS and tvOS apps. It displays a heads-up display (HUD) to show users that a time-consuming task is in progress, such as network requests or data processing. The library provides both indeterminate spinners and determinate progress bars, along with status messages and result indicators.

Target Audience

iOS and tvOS developers who need to add clean, user-friendly progress indicators to their applications. It's particularly useful for those building apps with asynchronous operations that require visual feedback.

Value Proposition

Developers choose SVProgressHUD for its simplicity, clean design, and extensive customization options. It's easy to integrate, supports both Objective-C and Swift, and offers features like haptic feedback and notification posting out of the box.

Overview

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

Use Cases

Best For

Displaying progress during network requests or data loading
Showing indeterminate spinners for tasks with unknown duration
Providing visual feedback for successful or failed operations
Customizing HUD appearance to match app design
Adding haptic feedback to progress indicators on supported devices
Implementing progress indicators in tvOS applications

Not Ideal For

Apps implementing pull-to-refresh or infinite scrolling mechanics
Projects built entirely with SwiftUI wanting native components
Teams preferring Swift-only libraries for easier maintenance and modern concurrency support

Pros & Cons

Pros

Easy Integration

Supports all major dependency managers including CocoaPods, Carthage, and SwiftPM, with clear installation instructions for quick setup.

Highly Customizable

Offers UIAppearance selectors for style, color, font, and size adjustments, allowing app-wide theming without invasive code changes.

Built-in Haptics

Automatically triggers UINotificationFeedbackType for success, error, and info states on compatible iPhones, enhancing user feedback without extra code.

Notification Support

Posts NSNotificationCenter events for HUD lifecycle and touch interactions, enabling seamless coordination with other app components.

Cons

Objective-C Codebase

Written in Objective-C, which may deter Swift-centric developers and lacks modern Swift features like async/await support, making integration feel dated.

No SwiftUI Native

Requires bridging via UIViewRepresentable to use in SwiftUI projects, adding complexity compared to libraries designed for SwiftUI's declarative syntax.

App Extension Hassle

Needs manual configuration like defining SV_APP_EXTENSIONS and calling setViewForExtension:, introducing setup overhead for extension targets.

Frequently Asked Questions

Related Projects

MBProgressHUD

MBProgressHUD + Customizations

Stars15,940

Forks3,564

Last commit1 year ago

SkeletonView

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

Stars12,886

Forks1,125

Last commit1 month ago

NVActivityIndicatorView

A collection of awesome loading animations

Stars10,706

Forks1,158

Last commit4 months ago

M13ProgressSuite

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

Stars3,901

Forks518

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