animated_toast 1.0.3

A Flutter package for displaying animated toast messages.

Animated Toast for Flutter

Animated Toast is a Flutter package that provides highly customizable and animated toast messages for your Flutter applications.

Preview

https://github.com/user-attachments/assets/f8ee5890-3ca0-4463-b84b-9383e7b4023a

with simple animation

https://github.com/user-attachments/assets/54629dd1-cd9c-4bfd-9adf-a66f28f5870e

🚀 Features

• 🎨 Fully customizable in appearance and behavior.
• 🔄 Smooth animations with configurable directions (top, bottom, left, right).
• 📍 Flexible positioning on the screen.
• ⏳ Configurable display duration.
• 🛠️ Easy to implement and use.

📦 Installation

Add the following dependency to your pubspec.yaml file:

dependencies:
  animated_toast: <version>

Then, run the following command to install the package:

flutter pub get

📝 Usage

Import the package in your Dart file:

import 'package:animated_toast/animated_toast.dart';

Show a Toast

AnimatedToast.show(
  context: context,
  messageData: MessageData(
    title: 'Success',
    subtitle: 'Operation completed successfully.',
  ),
);

AnimatedToast.simpleAnimation(
  context: context,
  messageData: MessageData(
    title: 'Success',
    subtitle: 'Operation completed successfully.',
  ),
);

Advanced Options

You can customize the position, style, and duration of the toast:

AnimatedToast.show(
  context: context,
  messageData: MessageData(
    title: 'Warning',
    subtitle: 'Check the details before proceeding.',
  ),
  position: AnimatedToastPosition(top: true),
  animationAlignment: AnimatedToastStartOf.bottom,
  duration: AnimatedToastDuration(
    begin: Duration(milliseconds: 500),
    displayDuration: Duration(seconds: 1),
  ),
);

📌 AnimatedToast API

Methods:

• AnimatedToast.show: Displays an animated toast message
• AnimatedToast.simpleAnimation: Displays a simple animated toast message without the first animation.

Parameters:

• context (required): Context in which the toast will be displayed.
• messageData (required): Content of the toast message.
• position (optional): Position on the screen.
• size (optional): Size of the toast.
• animationAlignment (optional): Animation start direction (default: AnimatedToastStartOf.top).
• style (optional): Custom style.
• duration (optional): Animation duration (default: 300ms).
• onDismiss (optional): Callback that is called when the toast is dismissed.

🤝 Contributions

Contributions are welcome! If you have ideas or improvements, open an issue or submit a pull request on GitHub.

📜 License

This project is licensed under the MIT License. See the LICENSE file for more details.

📬 Contact

For questions or suggestions, contact us at [[e-mail]].