hyperoslo/whisper

Whisper is a Swift library for iOS apps that makes it simple to show small notification messages inside the app itself. It was built by the design and development studio Hyper, and is available under the MIT license. The library provides three distinct types of in-app messages, each suited to a different kind of alert. The first, called a Whisper, shows a short message at the bottom of the navigation bar at the top of the screen. It can include text, an icon image, or a loading indicator, and can either disappear after a brief delay or stay on screen until dismissed. The second, called a Shout, is a more prominent notification that slides in from the top of the screen. Shouts can include a title, subtitle, and image, and can also trigger a function when the user taps on them. The third option, called a Whistle, is the most minimal of the three: a small, discreet indicator that appears in the status bar area. All three types can be customized in terms of colors and fonts. The library also handles a technical detail that can be tedious in iOS development: adjusting scroll position when a message appears or disappears so that content underneath is not obscured. This happens automatically without any extra setup. Usage follows a consistent pattern: you create a message object with the content you want to display, then call a show method on the Whisper namespace, passing in the relevant view controller and any options. The library is also usable from Objective-C code for projects that have not fully migrated to Swift. Installation is available through CocoaPods and Carthage, which are the two most common dependency managers for iOS projects. Both are listed in the README with the required configuration lines.