LNRSimpleNotifications

by LISNR

Simple Swift in-app notifications

202 Stars 26 Forks Last release: Not found Other 77 Commits 20 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

LNRSimpleNotifications

TSMessages is an amazingly powerful in-app notifications library but requires a lot of setup. LNRSimpleNotifications is a simplified version for the developer who wants beautiful in-app notifications in minutes.

Budweiser Made in America Screenshot LNRSimpleNotifications Demo Screenshot Wakarusa Screenshot

How do I set it up?

We're glad you asked.

If your project is in Swift:

  1. Add LNRSimpleNotifications to your Podfile or Package.swift.
  2. Add the AudioToolbox framework to your project.
  3. Add import LNRSimpleNotifications in the classes you want to trigger or style your in-app notifications.
  4. (Optional) Style your notifications in the class managing your notification's initializer.
  5. There is no step Five.

If your project is in Objective-C:

  1. Add LNRSimpleNotifications to your Podfile.
  2. Add the AudioToolbox framework to your project.
  3. Set "Defines Modules" to Yes in your build settings.
  4. Import the LNRSimpleNotification module's Xcode-generated Swift header file in the classes you want to trigger and style your in-app notifications. The name of this header should be #import <LNRSimpleNotifications/LNRSimpleNotifications-Swift.h>.
  5. (Optional) Style your notifications in the class managing your notification's initializer.

Demo Project

To run the demo project clone the repo, and run

pod install
from the Example directory first.

How do I use it?

Configure your notification styles once in your app. The init method for whatever class is triggering your in-app notifications is a good choice.

The Class Triggering Notifications

import LNRSimpleNotifications
import AudioToolbox

###

let notificationManager = LNRNotificationManager()

func init() { super.init()

notificationManager.notificationsPosition = LNRNotificationPosition.Top
notificationManager.notificationsBackgroundColor = UIColor.whiteColor()
notificationManager.notificationsTitleTextColor = UIColor.blackColor()
notificationManager.notificationsBodyTextColor = UIColor.darkGrayColor()
notificationManager.notificationsSeperatorColor = UIColor.grayColor()

var alertSoundURL: NSURL? = NSBundle.mainBundle().URLForResource("click", withExtension: "wav")
if let _ = alertSoundURL {
    var mySound: SystemSoundID = 0
    AudioServicesCreateSystemSoundID(alertSoundURL!, &amp;mySound)
    notificationManager.notificationSound = mySound
}

return true

}

You can also configure an icon that will appear in your notification and set a custom font for the notification title and body.

If you don't set any theme options your notifications will default to black text on a white background with no notification sound or icon.

The Class Triggering Notifications

let notificationManager = LNRNotificationManager()

func methodThatTriggersNotification:(title: String, body: String) { notificationManager.showNotification(notification: LNRNotification(title: title, body: body, duration: LNRNotificationDuration.default.rawValue, onTap: { () -> Void in print("Notification Dismissed") }, onTimeout: { () -> Void in print("Notification Timed Out") })) }

Who's using LNRSimpleNotifications?

At the moment we know we've used it in:

We're doing more music festivals this year, so you'll see our simple yet stylish notifications in our apps a few more times this Summer and Fall.

Have you used LNRSimpleNotifications in a project? Want your app featured here? Let us know at [email protected].

Known Bugs

Since 0.1.0

  1. If you trigger notifications very rapidly they'll start appearing immediately instead of waiting for the one before to be dismissed before displaying. If this happens notifications will start appearing over notifications that were already on screen.

Pull Requests?

Absolutely!

About LISNR

LISNR is a startup leveraging ultrasonic audio to transmit data between devices without a network. Using our technology we have synchronized light shows on phones at concerts, triggered location-based notifications, rewarded music fans with behind-the-scenes content, delivered at-shelf product information, and made art galleries come alive.

Want to know more about LISNR? Reach out to [email protected].

License

LNRSimpleNotifications is available under the MIT license. See LICENSE.txt for details.

Credits

LNRSimpleNotifications is based on TSMessages, developed by Felix Krause. If LNRSimpleNotifications isn't quite what you're looking for we recommend you check it out.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.