flashx 1.0.1

Beautiful, animated, and highly customizable snackbar, toast, and notification package for Flutter with zero boilerplate support.

🔥 FlashX

The most powerful, beautiful, and developer-friendly Flutter notification package. Zero boilerplate · Works with every state manager · Stunning by default.

---

✨ Why FlashX?

Feature	FlashX	fluttertoast	another_flushbar	bot_toast
All platforms	✅	⚠️ Limited	✅	✅
State mgmt. agnostic	✅	✅	✅	✅
Queue system	✅	❌	✅	✅
Priority queue	✅	❌	❌	❌
Future tracking API	✅	❌	❌	❌
Glassmorphism	✅	❌	❌	❌
7 built-in animations	✅	❌	⚠️ 2	⚠️ 3
Custom widget	✅	❌	✅	✅
Gradient backgrounds	✅	❌	❌	❌
Duplicate prevention	✅	❌	❌	❌
Dismiss by ID	✅	❌	❌	✅
Progress bar	✅	❌	✅	❌
RTL support	✅	✅	✅	✅
Dart 3 / null-safe	✅	✅	✅	✅

---

🚀 Quick Start (2 minutes)

1. Install

dependencies:
  flashx: ^1.0.0

flutter pub get

2. Initialize

Wrap your MaterialApp builder — that's it:

import 'package:flashx/flashx.dart';

void main() => runApp(const MyApp());

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      builder: FlashXWidget.init(), // ← One line
      home: HomeScreen(),
    );
  }
}

3. Show notifications

FlashX.success("Profile saved!");
FlashX.error("Payment failed.");
FlashX.warning("Weak internet connection.");
FlashX.info("Version 2.0 is available.");

Done. 🎉

---

🎛️ All APIs at a Glance

Convenience methods

FlashX.success("Saved");
FlashX.error("Failed", title: "Oops");
FlashX.warning("Low battery");
FlashX.info("New update");
final id = FlashX.loading("Uploading...");
FlashX.dismissById(id);
FlashX.dismissAll();

Full control with FlashOptions

FlashX.show(FlashOptions(
  title: "No Internet",
  message: "Please check your connection.",
  type: FlashType.error,
  position: FlashPosition.top,
  animation: FlashAnimation.elastic,
  duration: Duration(seconds: 5),
  actionText: "Retry",
  onAction: () => reconnect(),
  secondaryActionText: "Dismiss",
  onSecondaryAction: FlashX.dismissAll,
  showProgress: true,
  dismissDirection: FlashDismissDirection.horizontal,
  priority: FlashPriority.critical,
));

Future tracking

await FlashX.future(
  future: uploadData(),
  loading: "Uploading your file...",
  success: "Upload complete! 🎉",
  error: "Upload failed. Please retry.",
);

With dynamic messages based on result:

await FlashX.future<User>(
  future: fetchUser(),
  loading: "Fetching profile...",
  success: (user) => "Welcome back, ${user.name}!",
  error: (e) => "Error: ${e.toString()}",
);

Extension methods

// On BuildContext
context.flashSuccess("Saved!");
context.flashError("Failed!");

// On String
"Done!".flashSuccess();
"Oops!".flashError();

// On Future
uploadFile().flashFuture(
  loading: "Uploading...",
  success: (_) => "Done!",
  error: (e) => "Failed: $e",
);

---

🎨 Customization

Global config

FlashX.configure(FlashXConfig(
  position: FlashPosition.bottom,
  animation: FlashAnimation.bounce,
  duration: Duration(seconds: 3),
  borderRadius: BorderRadius.circular(20),
  blur: true,                   // Glassmorphism globally
  maxVisible: 3,                // Max stacked notifications
  stackedMode: false,           // Show one at a time (default)
  showProgress: true,
  dismissDirection: FlashDismissDirection.horizontal,
));

Custom theme per notification

FlashX.show(FlashOptions(
  type: FlashType.custom,
  message: "Premium feature unlocked.",
  themeData: FlashThemeData(
    backgroundColor: Color(0xFF1E1B4B),
    textColor: Colors.white,
    iconColor: Colors.amberAccent,
    actionColor: Colors.amber,
    progressColor: Colors.amber,
    borderColor: Color(0xFF312E81),
    borderWidth: 1,
  ),
));

Gradient background

FlashX.show(FlashOptions(
  type: FlashType.custom,
  title: "Pro Plan",
  message: "Upgrade to unlock all features.",
  themeData: FlashThemeData(
    backgroundColor: Colors.transparent,
    textColor: Colors.white,
    iconColor: Colors.white,
    actionColor: Colors.amber,
    progressColor: Colors.amber,
    gradient: LinearGradient(
      colors: [Color(0xFF7C3AED), Color(0xFFEC4899)],
    ),
  ),
  actionText: "Upgrade",
  onAction: () => openUpgradeScreen(),
));

Glassmorphism

FlashX.show(FlashOptions(
  type: FlashType.success,
  message: "Saved with glass effect!",
  themeData: FlashThemeData.glassSuccess(dark: false),
));

Or enable globally:

FlashX.configure(FlashXConfig(blur: true));

Custom widget

FlashX.show(FlashOptions(
  type: FlashType.custom,
  customWidget: Row(
    children: [
      CircleAvatar(backgroundImage: NetworkImage(avatarUrl)),
      SizedBox(width: 12),
      Expanded(
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text("Alice sent you a message"),
            Text("Hey! Are you free tonight?", style: TextStyle(fontSize: 12)),
          ],
        ),
      ),
    ],
  ),
));

---

🎞️ Animations

Name	Description
FlashAnimation.slide	Slides in from the nearest edge
FlashAnimation.fade	Fades in/out smoothly
FlashAnimation.scale	Scales from center with ease-out-back
FlashAnimation.elastic	Spring-like elastic entrance
FlashAnimation.bounce	Bouncy entrance
FlashAnimation.rotation	Rotation + scale + fade
FlashAnimation.ios	iOS-style cubic-emphasized curve

Custom animation builder

FlashX.show(FlashOptions(
  message: "Custom animation!",
  animationBuilder: (controller, child) {
    return SlideTransition(
      position: Tween(begin: Offset(-2, 0), end: Offset.zero)
          .animate(CurvedAnimation(parent: controller, curve: Curves.elasticOut)),
      child: child,
    );
  },
));

---

📋 Queue & Priority

// Normal (FIFO order)
FlashX.show(FlashOptions(message: "Normal", priority: FlashPriority.normal));

// Jumps ahead of normal items
FlashX.show(FlashOptions(message: "Important!", priority: FlashPriority.high));

// Goes to the front immediately
FlashX.show(FlashOptions(
  type: FlashType.error,
  message: "Critical error!",
  priority: FlashPriority.critical,
));

---

🔑 Duplicate Prevention

// Show only once even if called multiple times
for (int i = 0; i < 5; i++) {
  FlashX.show(FlashOptions(
    message: "You are offline",
    key: "offline_banner",  // ← unique key
  ));
}
// Only one notification is shown

---

🌐 Platform Support

Platform	Supported
Android	✅
iOS	✅
Web	✅
Windows	✅
macOS	✅
Linux	✅

---

🧩 State Management

FlashX has zero dependency on any state management solution. Use it with:

• ✅ GetX — call FlashX.success(...) anywhere
• ✅ Provider — no setup needed
• ✅ Riverpod — works in any ref.read() or callback
• ✅ Bloc/Cubit — call from BlocListener
• ✅ MobX — call from reactions
• ✅ Stacked — call from ViewModelBuilder
• ✅ setState — just call it!

---

🗺️ Roadmap

• ❌ Push-style grouped notifications
• ❌ Custom enter/exit path animations
• ❌ Notification history panel
• ❌ Haptic feedback support
• ❌ Sound/vibration customization
• ❌ Scheduled/delayed notifications
• ❌ Notification tap-through to routes

---

🤝 Contributing

Contributions, issues, and feature requests are welcome!

1. Fork the repo
2. Create your feature branch: git checkout -b feat/amazing-feature
3. Commit your changes: git commit -m 'feat: add amazing feature'
4. Push: git push origin feat/amazing-feature
5. Open a pull request

Please read CONTRIBUTING.md first.

---

📄 License

MIT License © 2025 FlashX Contributors