How to integrate Gradient Loading Bar with SwiftUI?

Import the framework and add GradientLoadingBarView to your SwiftUI hierarchy, then control visibility with state variables and modifiers like opacity or hidden, as detailed in the SwiftUI usage section. You can customize colors and animation speed directly in the view initializer.

GradientLoadingBar vs Apple's UIProgressView: which is better for iOS apps?

GradientLoadingBar offers visually appealing gradient animations and notch support, making it ideal for polished UIs, while UIProgressView is a standard, less customizable component. Choose GradientLoadingBar for visual flair, but note it lacks native progress tracking features like percentage display.

Can I change the gradient colors dynamically during runtime?

Yes, you can update the gradientColors property at any time for both UIKit (GradientActivityIndicatorView) and SwiftUI (via state binding), allowing real-time color changes. The README provides code snippets for setting colors in configuration.

Does Gradient Loading Bar work with iOS 15 or older versions?

For iOS 15, you need version 3.x.x, and for iOS < 13.0, version 2.x.x, as noted in the compatibility notes. The latest version requires iOS 26.0+, so check your target version and use the appropriate release.

How to position the loading bar below a navigation bar in UIKit?

Use the isRelativeToSafeArea parameter set to true or manually constrain GradientActivityIndicatorView to specific views, as shown in the UIKit integration examples. You can adjust height and anchors to fit your layout.

Is there a way to show progress percentage with Gradient Loading Bar?

No, the framework does not support displaying progress percentages; it is designed for continuous animation without numerical feedback. For progress tracking, you would need to supplement it with additional UI elements.

Open-Awesome

GradientLoadingBar

Q: How to position the loading bar below a navigation bar in UIKit?

Use the isRelativeToSafeArea parameter set to true or manually constrain GradientActivityIndicatorView to specific views, as shown in the UIKit integration examples. You can adjust height and anchors to fit your layout.

Q: Is there a way to show progress percentage with Gradient Loading Bar?

No, the framework does not support displaying progress percentages; it is designed for continuous animation without numerical feedback. For progress tracking, you would need to supplement it with additional UI elements.

MITSwift4.0.0

A customizable animated gradient loading bar for iOS with full SwiftUI and UIKit support.

Visit Website GitHub

894 stars63 forks0 contributors

What is GradientLoadingBar?

Gradient Loading Bar is an iOS framework that provides a customizable animated gradient loading bar. It solves the problem of bland progress indicators by offering visually engaging gradient animations that can be easily integrated into iOS applications. The framework supports both SwiftUI and UIKit, making it versatile for different project architectures.

Target Audience

iOS developers building applications with SwiftUI or UIKit who need visually appealing loading indicators. It's particularly useful for developers who prioritize user interface polish and want to replace standard progress bars with more engaging animations.

Value Proposition

Developers choose Gradient Loading Bar because it offers production-ready loading indicators with extensive customization options out of the box. Its dual support for SwiftUI and UIKit, along with features like notch wrapping and safe area handling, provides more flexibility than basic system indicators while maintaining easy integration.

Overview

⌛️A customizable animated gradient loading bar.

Use Cases

Best For

Adding polished loading indicators to iOS apps
Enhancing user experience during network requests
Creating custom navigation bar progress indicators
Building SwiftUI applications with animated UI feedback
Implementing notch-aware UI elements on iPhone
Replacing standard iOS activity indicators with gradient animations

Not Ideal For

Apps requiring detailed progress feedback with percentages or segmented stages
Projects targeting iOS versions below 13.0 without willingness to use older framework versions
Cross-platform applications built with frameworks like React Native or Flutter
Teams preferring minimal dependencies and fully native UI components

Pros & Cons

Pros

Dual Framework Support

Works seamlessly with both SwiftUI (via GradientLoadingBarView) and UIKit (via GradientActivityIndicatorView), allowing integration into any iOS project architecture as highlighted in the overview.

Highly Customizable Appearance

Offers adjustable height, gradient colors, animation speed, and safe area handling, with configuration examples for both UIKit and SwiftUI in the README.

Notch-Aware Design

Includes NotchGradientLoadingBar for wrapping around iPhone notches, demonstrated with device-specific screenshots and videos, enhancing modern UI compatibility.

Easy Integration

Provides a shared instance with simple fadeIn/fadeOut methods for quick setup, as shown in the usage examples for common scenarios like network requests.

Cons

No Progress Tracking

Lacks built-in support for progress percentages or state management, focusing solely on continuous gradient animation without feedback for tasks like file uploads.

Strict iOS Version Constraints

The latest version requires iOS 26.0+, and older iOS support necessitates downgrading to legacy versions, complicating projects with broader device compatibility needs.

Manual SwiftUI Control

The SwiftUI view requires explicit state management for visibility using modifiers like opacity, adding complexity compared to more integrated native components.

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,868

Forks1,125

Last commit27 days ago

SVProgressHUD

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

Stars12,463

Forks2,665

Last commit2 months ago

NVActivityIndicatorView

A collection of awesome loading animations

Stars10,713

Forks1,155

Last commit1 month ago

M13ProgressSuite

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

Stars3,910

Forks522

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