MRProgress
A collection of iOS drop-in components to visualize progress with blurred overlays, activity indicators, and progress views.
What is MRProgress?
MRProgress is an iOS library providing drop-in components to visualize progress during background tasks. It displays a dimmed overlay with a blurred box containing customizable indicators like circular progress views, activity spinners, and completion icons. It solves the need for polished, accessible progress indicators in iOS apps.
iOS developers building apps that require visual feedback for loading states, network requests, or long-running tasks. It's especially useful for those using AFNetworking or needing customizable progress UI.
Developers choose MRProgress for its modular component design, seamless AFNetworking integration, and polished visual effects like blur and motion. It offers more customization and accessibility than basic system indicators while being easier to integrate than building from scratch.
Overview
Collection of iOS drop-in components to visualize progress
Use Cases
Best For
- Showing progress during network requests with AFNetworking
- Displaying loading overlays with blurred backgrounds in iOS apps
- Implementing circular progress indicators similar to the App Store
- Adding accessible progress feedback with UIAccessibility support
- Creating custom activity indicators with tint color customization
- Integrating progress views into UINavigationController navigation bars
Not Ideal For
- iOS apps targeting versions below iOS 7, as MRProgress requires iOS 7 and above for its blur and framework dependencies.
- Projects using modern networking libraries like Alamofire, since its deep integration is specifically for AFNetworking and lacks native support for others.
- SwiftUI-based applications, as MRProgress is built for UIKit and requires bridging, making it less seamless than native SwiftUI solutions.
- Teams preferring minimal dependency management, due to its complex CocoaPods subspec tree and warnings against relying on internal implementation details.
Pros & Cons
Pros
Allows using individual components like MRActivityIndicatorView or MRCircularProgressView without the full overlay, enabling flexible integration as highlighted in the README's component-oriented philosophy.
Provides built-in category methods to bind progress to AFNetworking tasks, automating mode changes and animations for network operations, as detailed in the usage section.
Includes blur backgrounds and UIMotionEffects similar to UIAlertView, offering a professional look with customizable tint colors, as shown in the overlay view descriptions and screenshots.
Supports UIAccessibility with labels, traits, and events, ensuring inclusive design for users with disabilities, which is explicitly listed as a key feature.
Cons
Relies on iOS 7-era blur implementations from WWDC 2013 and requires AFNetworking, which may not align with modern iOS development trends like Swift Concurrency or newer networking libraries.
The CocoaPods subspec tree is intricate, and the README warns against relying on internal specs, adding overhead and potential fragility for project setup.
Lacks native Swift or SwiftUI compatibility, requiring bridging headers and extra work for Swift projects, unlike newer libraries designed for modern iOS ecosystems.
Open Source Alternative To
MRProgress is an open-source alternative to the following products:
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
SVProgressHUDA clean and lightweight progress HUD for your iOS and tvOS app.
NVActivityIndicatorViewA collection of awesome loading animations
M13ProgressSuiteA suite containing many tools to display progress information on iOS.
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.