Toastification

To display toast messages without providing a context (e.g., from a service or logic class), wrap your root AppWidget with the ToastificationWrapper. This enables the use of toastification.show and toastification.showCustom globally within the app.

return ToastificationWrapper(
  child: MaterialApp(),
);

If you cannot access BuildContext (e.g., in GetX or deep logic layers), you can use a GlobalKey<NavigatorState> to show toasts via the overlayState.

1. Create a key: final GlobalKey<NavigatorState> globalNavigatorKey = GlobalKey<NavigatorState>();
2. Assign it to your MaterialApp: MaterialApp(navigatorKey: globalNavigatorKey, ...)
3. Use the key to access the overlay:

For show():

toastification.show(
  overlayState: globalNavigatorKey.currentState?.overlay,
  title: Text('Hello, World!'),
);

For showCustom():

toastification.showCustom(
  overlayState: globalNavigatorKey.currentState?.overlay,
  builder: (context, holder) {
     return YourCustomWidget();
  },
);

toastification.show(
  overlayState: navigatorKey.currentState?.overlay,
  autoCloseDuration: const Duration(seconds: 5),
  title: Text('Hello, World!'),
);

Add toastification to your pubspec.yaml dependencies and run flutter pub get to install the package.

dependencies:
  toastification: latest_version

To change the image used for the iOS launch screen, you can either replace the image files directly in the example/ios/Runner/Assets.xcassets/LaunchImage.imageset/ directory or use Xcode for a more visual approach.

Using Xcode:

1. Open your Flutter project's iOS workspace using the command: open ios/Runner.xcworkspace.
2. In the Xcode Project Navigator, navigate to Runner/Assets.xcassets.
3. Drag and drop your desired images into the asset catalog to replace the existing launch images.

The package provides a global singleton instance named toastification for easy access throughout your application. You can use this instance directly instead of instantiating Toastification() every time.

import 'package:toastification/toastification.dart';

// Use the pre-defined singleton
toastification.show(...);

A ToastificationItem represents an individual toast notification instance. It contains the configuration for how the toast is built, where it is aligned, and how it animates.

Important: Do not instantiate ToastificationItem directly. Instead, use the Toastification class (via show or showCustom methods) to create instances. The returned ToastificationItem can be used to manually control the toast's lifecycle (starting, pausing, or stopping the auto-close timer) or to identify specific toasts via their unique id.

The blockBackgroundInteraction property in ToastificationConfig controls whether the user can interact with the background UI while a toast is visible.

• When true: The background is blocked from receiving touch events.
• When false (default): The background remains interactive.

ToastificationConfig(
  blockBackgroundInteraction: true, // Blocks background interaction
  // ... other configuration options
)

To use Toastification (especially to enable the show method without a BuildContext), you must wrap your application's root widget with the ToastificationWrapper. This widget initializes the global overlay and provides configuration to all descendant widgets.

If you do not wrap your app with ToastificationWrapper, calling toast methods will result in a FlutterError stating that Toastification is not initialized.

ToastificationWrapper(
  config: ToastificationConfig(
    // your global configuration here
  ),
  child: MaterialApp(
    title: 'My Application',
    home: HomePage(),
  ),
);

You can implement custom entry/exit animations for toast notifications by providing an animationBuilder function and specifying an animationDuration. The animationBuilder provides the context, an animation object (typically an Animation<double>), the alignment, and the child (the toast widget itself).

ttoastification.show(
  context: context,
  title: Text('Hello, world!'),
  // .... Other parameters
  animationDuration: const Duration(milliseconds: 300),
  animationBuilder: (context, animation, alignment, child) {
    return RotationTransition(
      turns: animation,
      child: child,
    );
  },
);