explaingit

tapadoo/alerter

5,514KotlinAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

Alerter is an Android library that shows customizable notification banners sliding in from the top of the screen, offering more flexibility than standard Android Toasts and Snackbars for in-app user feedback.

Mindmap

mindmap
  root((Alerter))
    What it does
      Top-screen banners
      Auto-dismiss
      Custom layouts
    Customization
      Colors and icons
      Action buttons
      Progress bar
    Use Cases
      Success messages
      Error alerts
      User feedback
    Tech Stack
      Kotlin
      Android
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Show success, warning, or error banners at the top of your Android app screen instead of basic Toasts.

USE CASE 2

Add a countdown progress bar to a notification that auto-dismisses after a set number of seconds.

USE CASE 3

Replace all Toast messages in an Android project with branded, tappable alerts using custom colors and icons.

USE CASE 4

Trigger a custom action or navigate to a screen when the user taps a notification banner.

Tech stack

KotlinAndroid

Getting it running

Difficulty · easy Time to first run · 5min

Add a few lines to build.gradle and call show() in a method chain, no API keys or external services needed.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Alerter is an Android library written in Kotlin that gives app developers a better way to show notifications to users inside their app. Standard Android provides two built-in options for brief messages: Toasts (small pop-up bubbles at the bottom of the screen) and Snackbars (bars that also appear at the bottom). Both have limited customization. Alerter adds a third option: a banner that slides in from the top of the screen and overlays all other content. Adding it to an Android project takes just a few lines in the project's build files. Once installed, you display an alert with a short chain of method calls: create an alert, set a title and text, then call show. The alert dismisses itself after a set amount of time. The library offers a range of customization options. You can change the background color, swap in a custom icon, control how long the alert stays on screen, add a click listener that runs when the user taps it, or include action buttons. Text can be short or long, and the alert resizes itself to fit. You can also enable a progress bar that fills as the timer counts down, or let users swipe the alert away to dismiss it. For more advanced use, you can pass in a completely custom layout, replacing the default design with your own. The library also provides callbacks that fire when an alert appears or disappears, so you can chain other actions to those moments. Alerter is open-source under the MIT license, meaning you can use it in any project, including commercial ones, as long as you keep the copyright notice.

Copy-paste prompts

Prompt 1
Add an Alerter banner to my Android app that shows a success message in green with a checkmark icon after form submission.
Prompt 2
Show a dismissible error alert using Alerter with a retry button when a network call fails in my Kotlin Android app.
Prompt 3
Configure an Alerter notification with a progress bar that counts down for 5 seconds before auto-dismissing.
Prompt 4
Replace all Toast messages in my Android project with Alerter banners that use my app's brand colors.
Open on GitHub → Explain another repo

← tapadoo on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.