How do I create a custom theme in InAppNotify?

Initialize a Theme object with properties like titleFont and backgroundColor, as shown in the README example, then set it globally using InAppNotify.theme. This allows full control over colors, fonts, and other visual aspects.

Does InAppNotify work with SwiftUI?

No, it's built for UIKit and requires a UIViewController for presentation, so it's not directly compatible with SwiftUI. You'd need to wrap it in a UIViewControllerRepresentable for SwiftUI projects, adding complexity.

InAppNotify vs NotificationBanner: which should I use?

InAppNotify is better for interactive, messaging-style notifications with swipe-to-reply features, while NotificationBanner offers more pre-built styles and simpler setup for basic alerts. Choose based on customizability vs convenience.

How can I handle user text input from notifications?

Set the interactionType to .text in the Announcement object, then use the action callback to detect CallbackType.text and access the reply string. Customize the send button text with InAppNotify.sendString for a tailored experience.

Is InAppNotify accessible for VoiceOver users?

The README doesn't mention accessibility features, so it likely lacks built-in support for VoiceOver or dynamic type. You may need to manually add accessibility labels or traits if required for your app.

Can I dismiss notifications programmatically?

No direct method is provided in the README; notifications auto-dismiss after the duration set or via user swipe. For programmatic control, you might need to extend the library or manage notification state externally.

Open-Awesome

InAppNotify

MITSwift

A Swift library for displaying customizable in-app notifications similar to WhatsApp and Telegram.

GitHub

429 stars33 forks0 contributors

What is InAppNotify?

InAppNotify is a Swift library for iOS that allows developers to display customizable in-app notifications. It solves the problem of showing interactive alerts, announcements, or messages within an app, similar to the notification systems in WhatsApp and Telegram. Developers can present notifications with titles, subtitles, images, and interactive elements like reply text fields.

Target Audience

iOS developers building apps that require in-app messaging, alerts, or announcements, particularly those looking for a ready-to-use, customizable notification component.

Value Proposition

Developers choose InAppNotify for its ease of integration, high customizability, and familiar interaction patterns modeled after popular messaging apps. It offers a lightweight, native Swift solution with support for themes, gestures, and callbacks.

Overview

Swift library to manage in app notification in swift language, like WhatsApp, Telegram, Frind, ecc.

Use Cases

Best For

Adding WhatsApp-style message previews in iOS apps
Displaying interactive announcements or alerts within an app
Implementing in-app notification centers for messaging features
Creating customizable toast or banner notifications in Swift
Building apps that require user replies directly from notifications
Enhancing user engagement with rich, interactive notifications

Not Ideal For

Cross-platform applications needing consistent notifications on iOS, Android, and web
Projects requiring integrated server-side push notification handling with APNs or Firebase
Teams wanting pre-styled, drop-in notification components without custom theme coding
Applications with stringent accessibility requirements like VoiceOver support out-of-the-box

Pros & Cons

Pros

Orientation Flexibility

Seamlessly works in both portrait and landscape modes, as explicitly listed in the main features, ensuring notifications adapt to device orientation.

High Customizability

Every visual element can be customized programmatically, including fonts, colors, and themes, with detailed examples for creating custom themes in the README.

Interactive Gestures

Supports swipe-up to dismiss or swipe-down to reveal a reply text field, mimicking popular messaging apps like WhatsApp and Telegram for intuitive user interaction.

Easy Integration

Simple CocoaPods installation and a straightforward Show method make it quick to add in-app notifications to any UIViewController, with minimal setup code required.

Cons

Outdated Swift Support

Only compatible with Swift 4, which is several versions behind current standards, potentially requiring migration efforts or limiting use in modern Swift 5+ projects.

Limited Documentation

README provides basic usage examples but lacks advanced guides, API references, or community contributions, making troubleshooting or extension challenging.

Single Installation Method

Supports only CocoaPods for dependency management, with no mention of Swift Package Manager or Carthage, restricting integration options for diverse project setups.

Frequently Asked Questions

Related Projects

SwiftMessages

A very flexible message bar for UIKit and SwiftUI.

Stars7,548

Forks765

Last commit7 months ago

Alerts & Pickers

Advanced usage of UIAlertController and pickers based on it: Telegram, Contacts, Location, PhotoLibrary, Country, Phone Code, Currency, Date...

Stars5,761

Forks701

Last commit2 years ago

BulletinBoard

General-purpose contextual cards for iOS

Stars5,337

Forks301

Last commit4 years ago

SCLAlertView-Swift

Beautiful animated Alert View. Written in Swift

Stars5,307

Forks749