How to customize the colors in StatusBarOverlay?

StatusBarOverlay offers full customization of colors and text through its API. You can set properties like background and text color to match your app's design, as mentioned in the features section of the README.

StatusBarOverlay vs building a custom network indicator?

StatusBarOverlay saves development time with automatic detection and notch support, whereas a custom solution requires manual handling of network events and status bar overrides. However, for apps needing fine-grained control, custom code might be more flexible.

Does StatusBarOverlay work with SwiftUI?

No, StatusBarOverlay is built for UIKit and requires UIViewController-based setup. For SwiftUI apps, you would need to use UIKit integration or find an alternative library designed for SwiftUI.

How to manually show the overlay with custom text?

You can trigger the overlay manually by calling StatusBarOverlay methods with custom text, useful for debug or demo modes. The README indicates this is an optional feature beyond automatic connectivity alerts.

What if my app doesn't have a common UIViewController subclass?

You would need to add the status bar overrides to each view controller or create a base class. This can be intrusive and time-consuming for large apps with diverse view controller structures.

Can StatusBarOverlay check connectivity to multiple hosts?

No, it uses a single host domain set via StatusBarOverlay.host for connectivity checks. If you need to monitor multiple endpoints, you might need to modify the library or use a different approach.

Open-Awesome

StatusBarOverlay

MITSwift3.1.0

Automatically displays a 'No Internet Connection' bar in iOS apps when connectivity is lost, with support for hidden status bars and the notch.

GitHub

162 stars25 forks0 contributors

What is StatusBarOverlay?

StatusBarOverlay is an iOS library that automatically displays a 'No Internet Connection' bar at the top of the screen when an app loses connectivity. It solves the problem of informing users about network status without requiring manual checks or custom UI implementations, and it handles modern iOS interface elements like the notch and hidden status bars seamlessly.

Target Audience

iOS developers building apps that require clear network status indicators, especially those with full-screen interfaces or apps that hide the status bar. It's ideal for developers who want a simple, automatic solution for connectivity feedback.

Value Proposition

Developers choose StatusBarOverlay because it provides a zero-configuration solution for network status alerts with automatic detection, notch support, and minimal code integration. Its ability to work with hidden status bars and offer customization makes it a robust alternative to building similar functionality from scratch.

Overview

StatusBarOverlay will automatically show a "No Internet Connection" bar when your app loses connection, and hide it again. It supports apps which hide the status bar and The Notch

Use Cases

Best For

Adding automatic network status indicators to iOS apps
Handling connectivity alerts in apps with hidden status bars
Ensuring notch compatibility for top-aligned overlays
Displaying non-intrusive dropdown alerts below the status bar
Implementing debug or demo mode banners with custom text
Providing user feedback for network-dependent features

Not Ideal For

Apps targeting multiple platforms beyond iOS (e.g., React Native or Flutter projects)
Projects with highly customized or dynamic status bar management that conflicts with library overrides
Teams preferring manual network detection without automatic overlays or external dependencies

Pros & Cons

Pros

Automatic Connectivity Detection

Monitors network reachability and automatically shows/hides the overlay when connection is lost and regained, requiring minimal code as highlighted in the features.

Notch and Hidden Bar Support

Fully supports iPhone X and newer devices with the notch, and works correctly in apps that hide the status bar permanently, addressing modern iOS interface challenges.

Customizable Display Options

Allows manual triggering with custom text for debug or demo modes, and supports dropdown messages with click handlers for non-intrusive alerts, per the README.

Easy Integration

Setup involves just a few lines of code in AppDelegate and ViewController overrides, making it quick to implement for automatic functionality.

Cons

Simulator Reliability Issues

The README admits that on the simulator, the hiding event sometimes isn't fired, which can hinder development and testing consistency.

Dependency on Reachability

Requires the Reachability library for connectivity events, adding an external dependency that needs to be managed and updated.

Intrusive Setup Requirements

Necessitates overriding status bar properties in a common UIViewController subclass, which can be cumbersome for apps without such a structure or with complex view hierarchies.

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

SVProgressHUD

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

Stars12,453

Forks2,666

Last commit4 months ago

NVActivityIndicatorView

A collection of awesome loading animations

Stars10,706

Forks1,158