pkluz/pkhud

PKHUD is a Swift library for iOS app developers that provides a heads-up display overlay, the small floating popup that Apple uses for things like the volume indicator, rotation lock notification, and similar brief status messages. If you have ever seen a translucent rounded square appear momentarily on an iPhone screen to confirm an action, this library recreates that style for use inside your own apps. The library ships with several ready-made content views: a checkmark for success, an X for failure, a spinning progress indicator, and a few others, all animated. You add it to your Xcode project through CocoaPods, Carthage, or Swift Package Manager (three standard iOS dependency tools), import the module with one line, and then show a HUD with a single function call. For example, calling HUD.flash(.success, delay: 1.0) displays a checkmark overlay that disappears after one second. You can also attach a completion handler to run code after the HUD finishes showing. For longer tasks, you can show a progress indicator when an operation starts and then swap it out for a success or error view when the operation finishes, all without dismissing and re-showing the overlay. This makes it straightforward to give users visual feedback during network requests or file operations without writing custom animation code. The library has two main customization knobs: whether the background behind the HUD is dimmed slightly, and whether the underlying screen remains interactive while the HUD is visible. Custom content views are also supported if the built-in options do not fit your needs, though the blur effect, corner radius, and shading style are intentionally fixed and cannot be changed. PKHUD requires iOS 8 or later and is released under the MIT License, meaning you can use it in free or commercial apps without restriction.