Search packages, repositories and app categories

ducafecatFlutter ecosystem guide
status_alert cover
Package detailsv3.0.1

status_alert

Display Apple system-like self-hiding status alerts. It is well suited for notifying user without interrupting user flow.

AndroidiOSWebmacOSWindowsLinux
pub.dev API documentation Source code
30-day downloads
698
Likes
287
Pub points
160

Install package

flutter pub add status_alert

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

A Flutter package that displays system-style, self-hiding status alerts inspired by Apple's UI. These non-intrusive notifications appear briefly at the top of the screen and automatically disappear, making them ideal for providing feedback without disrupting user flow. Designed with a clean, minimal aesthetic, it supports multiple platforms including Android, iOS, Web, macOS, Windows, and Linux. The package is lightweight and easy to integrate, offering smooth animations and reliable behavior across devices.

Use cases

  • Displaying success messages after form submission
  • Showing temporary error notifications
  • Providing feedback on user actions
  • Informing users of background process updates
  • Enhancing UX with subtle, non-blocking alerts

Key features

  • Self-hiding notifications
  • Apple-style visual design
  • Cross-platform compatibility
  • Smooth fade-in/fade-out animations
  • Simple API with minimal setup
  • Configurable duration and position

Suitable for

  • Apps requiring lightweight feedback
  • Developers prioritizing user experience
  • Projects targeting multiple platforms
  • UIs where interruptions must be avoided
  • Teams wanting native-like alert styling

Considerations

  • Not suitable for persistent or critical alerts
  • Limited customization beyond basic styling
  • Requires proper context for correct positioning
  • May not work as expected in complex widget trees
  • Best used for short-lived, non-urgent messages

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Status Alert for Flutter

Pub Version CI

Display Apple system-like self-hiding status alerts. Well suited for notifying users without interrupting their flow.

Installing

dependencies:
  status_alert: ^2.0.0

import 'package:status_alert/status_alert.dart';

Basic Usage

StatusAlert.show(
  context,
  duration: Duration(seconds: 2),
  title: 'Subscribed',
  subtitle: 'You will be notified of new posts',
  configuration: IconConfiguration(icon: Icons.done),
  maxWidth: 260,
);

Parameters

Parameter Type Default Description
title String? null Main text
subtitle String? null Secondary text
configuration PopupMediaConfiguration? null Icon or custom widget
duration Duration 1300ms How long the alert stays visible
backgroundColor Color? Theme-based Alert background
blurPower double 2.0 Background blur sigma
maxWidth double? null Max width on large screens
alignment Alignment center Alert position on screen
margin EdgeInsets all(40) Outer spacing
padding EdgeInsets all(30) Inner spacing
borderRadius BorderRadius circular(10) Corner radius
dismissOnBackgroundTap bool false Dismiss when background is tapped
onComplete VoidCallback? null Called after dismiss animation ends
titleOptions StatusAlertTextConfiguration? null Title text styling
subtitleOptions StatusAlertTextConfiguration? null Subtitle text styling

Media Configurations

Icon
StatusAlert.show(
  context,
  title: 'Done',
  configuration: IconConfiguration(
    icon: Icons.check_circle,
    color: Colors.green,
    size: 60,
  ),
);
Custom Widget (e.g. Rive animation)
StatusAlert.show(
  context,
  title: 'Loading',
  configuration: WidgetConfiguration(
    widget: RiveAnimation.asset('assets/animation.riv'),
  ),
);

Programmatic Control

// Show
StatusAlert.show(context, title: 'Saved');

// Hide manually
StatusAlert.hide();

// Check visibility
if (StatusAlert.isVisible) { ... }

onComplete Callback

Called after the alert finishes its dismiss animation:

StatusAlert.show(
  context,
  title: 'Uploaded',
  onComplete: () => Navigator.push(context, ...),
);

Migration from 1.x

1.x 2.x
FlareConfiguration Use WidgetConfiguration with a Rive widget
textScaleFactor in StatusAlertTextConfiguration Use textScaler
Dart SDK <3.0.0 Requires Dart >=3.0.0

Apple Podcasts vs Status Alert

License

This project is licensed under the Apache License 2.0 — see the LICENSE file for details.

Categories

Dialogs

Dependencies

Dependency list 1 items

Source repository

Projects using this package

No data available yet.