🚀 Custom Quick Alert

📖 Table of Contents

• ✨ Features
• 🎯 Demo
• 🚀 Quick Start
• 📱 API Reference
• 🎨 Customization
• 💡 Real-World Examples
• 🔧 Advanced Usage
• 📚 Migration Guide
• 🌍 Platform Support
• 🔍 Troubleshooting
• 🤝 Contributing
• 📄 License

✨ Features

🎯 Demo

🎬 Live Demonstration

Experience the full power of Custom Quick Alert in action

📱 Alert Types Showcase

Success ✅	Error ❌	Warning ⚠️

Info ℹ️	Confirm 🤔	Loading ⏳

🎨 Dialog Previews

Success Dialog ✅	Error Dialog ❌	Warning Dialog ⚠️

Info Dialog ℹ️	Confirm Dialog 🤔	Loading Dialog ⏳

🚀 Quick Start

📦 Installation

Add to your pubspec.yaml:

dependencies:
  custom_quick_alert: ^2.1.1

Install the package:

flutter pub add custom_quick_alert

⚙️ Setup (One-Time Configuration)

📌 Important: Configure the global navigator key for context-free usage:

import 'package:flutter/material.dart';
import 'package:custom_quick_alert/custom_quick_alert.dart';

// 1. Create global navigator key
final GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();

void main() {
  runApp(const MyApp());
  // 2. Initialize CustomQuickAlert
  CustomQuickAlert.initialize(navigatorKey);
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      navigatorKey: navigatorKey, // 3. Assign navigator key
      title: 'Custom Quick Alert Demo',
      home: const HomePage(),
    );
  }
}

🎯 Basic Usage

import 'package:custom_quick_alert/custom_quick_alert.dart';

// ✅ Success Alert
CustomQuickAlert.success(
  title: 'Success!',
  message: 'Operation completed successfully.',
);

// ❌ Error Alert
CustomQuickAlert.error(
  title: 'Error Occurred',
  message: 'Please try again later.',
);

// ⚠️ Warning Alert
CustomQuickAlert.warning(
  title: 'Warning',
  message: 'Please review your input.',
);

// ℹ️ Info Alert
CustomQuickAlert.info(
  title: 'Information',
  message: 'Here is some important information.',
);

// 🤔 Confirmation Dialog
CustomQuickAlert.confirm(
  title: 'Logout Confirmation',
  message: 'Are you sure you want to logout?',
  confirmText: 'Yes, Logout',
  cancelText: 'Cancel',
  onConfirm: () {
    // Logout logic
    print('User logged out');
  },
  onCancel: () {
    // Stay logged in
    print('User cancelled logout');
  },
);

// ⏳ Loading Alert
CustomQuickAlert.loading();

// Dismiss loading after some time
Future.delayed(Duration(seconds: 3), () {
  CustomQuickAlert.dismiss();
  
  CustomQuickAlert.success(
    title: 'Complete!',
    message: 'Your request has been processed.',
  );
});

// 🎨 Custom Alert
CustomQuickAlert.custom(
  title: 'Welcome!',
  message: 'Thank you for joining our premium membership.',
  backgroundColor: Colors.deepPurple,
  titleColor: Colors.white,
  messageColor: Colors.white70,
  confirmText: 'Get Started',
  confirmBtnColor: Colors.amber,
  borderRadius: 20.0,
  width: 300,
  customContent: Column(
    children: [
      Icon(Icons.star, color: Colors.amber, size: 50),
      SizedBox(height: 10),
      Text('Premium Features Unlocked!', 
           style: TextStyle(color: Colors.white)),
    ],
  ),
);

📚 Comprehensive Examples

🎬 Animation Types

// Scale animation (default)
CustomQuickAlert.success(
  title: 'Scale Animation',
  message: 'This alert scales in.',
  animationType: QuickAlertAnimationType.scale,
);

// Fade animation
CustomQuickAlert.info(
  title: 'Fade Animation',
  message: 'This alert fades in.',
  animationType: QuickAlertAnimationType.fade,
);

// Slide animations
CustomQuickAlert.warning(
  title: 'Slide Animation',
  message: 'This alert slides in from top.',
  animationType: QuickAlertAnimationType.slideInDown,
);

// Other slide options:
// QuickAlertAnimationType.slideInUp
// QuickAlertAnimationType.slideInLeft
// QuickAlertAnimationType.slideInRight

📍 Position Examples

// Top position - Perfect for notifications
CustomQuickAlert.success(
  title: 'Top Alert',
  message: 'This alert appears at the top.',
  position: QuickAlertPosition.top,
  autoCloseDuration: Duration(seconds: 3),
);

// Center position (default) - Best for important dialogs
CustomQuickAlert.info(
  title: 'Center Alert',
  message: 'This alert appears in the center.',
  position: QuickAlertPosition.center,
);

// Bottom position - Great for confirmations
CustomQuickAlert.warning(
  title: 'Bottom Alert',
  message: 'This alert appears at the bottom.',
  position: QuickAlertPosition.bottom,
);

⏰ Auto-dismiss & Callbacks

// Auto-dismiss functionality
CustomQuickAlert.success(
  title: 'Auto-dismiss',
  message: 'This alert will close automatically in 3 seconds.',
  autoCloseDuration: Duration(seconds: 3),
  showConfirm: false, // Hide confirm button for auto-dismiss
);

// Callback functions
CustomQuickAlert.confirm(
  title: 'Save Changes?',
  message: 'You have unsaved changes. Do you want to save them?',
  onConfirm: () {
    print('Changes saved!');
    // Save logic here
  },
  onCancel: () {
    print('Changes discarded!');
    // Discard logic here
  },
);

// Advanced callbacks with navigation
CustomQuickAlert.success(
  title: 'Registration Complete',
  message: 'Welcome to our app! Let\'s get you started.',
  onConfirm: () {
    // Navigate to home screen
    Navigator.of(navigatorKey.currentContext!).pushReplacementNamed('/home');
  },
);

🎨 Advanced Styling

// Professional success alert with enhanced styling
CustomQuickAlert.success(
  title: 'Payment Successful',
  message: 'Your transaction has been processed securely.',
  useGradientButtons: true,
  backgroundColor: Colors.green.shade50,
  titleColor: Colors.green.shade800,
  messageColor: Colors.green.shade600,
  confirmBtnColor: Colors.green.shade600,
  borderRadius: 20.0,
  width: 350,
  padding: EdgeInsets.all(24),
);

// Custom styled error alert
CustomQuickAlert.error(
  title: 'Connection Failed',
  message: 'Please check your internet connection and try again.',
  confirmBtnColor: const Color(0xFFE53E3E),
  backgroundColor: const Color(0xFFFFF5F5),
  titleColor: const Color(0xFFE53E3E),
  messageColor: const Color(0xFF742A2A),
  borderRadius: 16.0,
  confirmText: 'Retry',
  showCancel: true,
  cancelText: 'Cancel',
);

// Dark theme custom alert
CustomQuickAlert.custom(
  title: 'Dark Theme Alert',
  message: 'This alert uses a dark theme design.',
  backgroundColor: Color(0xFF1E1E1E),
  titleColor: Colors.white,
  messageColor: Colors.white70,
  confirmBtnColor: Colors.blue,
  confirmTextColor: Colors.white,
  borderRadius: 25.0,
);

🎭 Barrier & Interaction Control

// Dismissible by tapping outside
CustomQuickAlert.info(
  title: 'Dismissible Alert',
  message: 'Tap outside to dismiss this alert.',
  barrierDismissible: true, // Allow tap outside to dismiss
);

// Prevent back button dismissal
CustomQuickAlert.loading(
  title: 'Processing Payment...',
  message: 'Please do not close the app during payment processing.',
  disableBackButton: true, // Prevents back button from dismissing
);

// Custom content widget
CustomQuickAlert.custom(
  title: 'Rate Our App',
  customContent: Column(
    mainAxisSize: MainAxisSize.min,
    children: [
      Text('How would you rate your experience?'),
      SizedBox(height: 20),
      Row(
        mainAxisAlignment: MainAxisAlignment.center,
        children: List.generate(5, (index) => 
          IconButton(
            icon: Icon(Icons.star, color: Colors.amber),
            onPressed: () {
              // Handle rating
              CustomQuickAlert.dismiss();
            },
          ),
        ),
      ),
    ],
  ),
  showConfirm: false,
  showCancel: false,
);

📱 API Reference

🎯 Alert Types

// Available alert types with their use cases
CustomQuickAlert.success()   // ✅ Success notifications & confirmations
CustomQuickAlert.error()     // ❌ Error messages & exceptions
CustomQuickAlert.warning()   // ⚠️ Warning alerts & cautions
CustomQuickAlert.info()      // ℹ️ Information dialogs & tips
CustomQuickAlert.confirm()   // 🤔 Confirmation dialogs & decisions
CustomQuickAlert.loading()   // ⏳ Loading indicators & progress
CustomQuickAlert.custom()    // 🎨 Fully customizable alerts

⚡ Quick Methods

// 🚫 Dismiss current alert
CustomQuickAlert.dismiss();

// 🎯 Check if alert is showing
bool isShowing = CustomQuickAlert.isShowing();

📊 Core Parameters

🎨 Styling Parameters

🎨 Customization

🎭 Animation Types

// Scale animation (default)
CustomQuickAlert.success(
  animationType: QuickAlertAnimationType.scale,
);

// Slide animations
CustomQuickAlert.info(
  animationType: QuickAlertAnimationType.slideInDown,
);

CustomQuickAlert.warning(
  animationType: QuickAlertAnimationType.slideInUp,
);

CustomQuickAlert.error(
  animationType: QuickAlertAnimationType.slideInLeft,
);

// Fade animation
CustomQuickAlert.custom(
  animationType: QuickAlertAnimationType.fade,
  lottieAsset: 'assets/animations/custom.json',
);

📍 Position Options

// Top positioned - Perfect for notifications
CustomQuickAlert.info(
  title: 'New Update Available',
  message: 'Version 2.0 is ready to install.',
  position: QuickAlertPosition.top,
);

// Center positioned (default) - Best for important dialogs
CustomQuickAlert.success(
  title: 'Payment Successful',
  message: 'Your transaction has been completed.',
  position: QuickAlertPosition.center,
);

// Bottom positioned - Great for confirmations
CustomQuickAlert.warning(
  title: 'Delete Item?',
  message: 'This action cannot be undone.',
  position: QuickAlertPosition.bottom,
  showCancel: true,
);

🎨 Professional Styling

// Professional success alert with enhanced styling
CustomQuickAlert.success(
  title: 'Payment Successful',
  message: 'Your transaction has been processed securely.',
  useGradientButtons: true,
  customShadows: [
    BoxShadow(
      color: Colors.green.withValues(alpha: 0.2),
      blurRadius: 20,
      offset: const Offset(0, 10),
    ),
    BoxShadow(
      color: Colors.green.withValues(alpha: 0.1),
      blurRadius: 40,
      offset: const Offset(0, 20),
    ),
  ],
  backgroundColor: Colors.green.shade50,
  titleColor: Colors.green.shade800,
  messageColor: Colors.green.shade600,
  confirmBtnColor: Colors.green.shade600,
  borderRadius: 16.0,
);

// Custom styled error alert
CustomQuickAlert.error(
  title: 'Connection Failed',
  message: 'Please check your internet connection and try again.',
  confirmBtnColor: const Color(0xFFE53E3E),
  backgroundColor: const Color(0xFFFFF5F5),
  titleColor: const Color(0xFFE53E3E),
  messageColor: const Color(0xFF742A2A),
  borderRadius: 16.0,
  customShadows: [
    BoxShadow(
      color: Colors.red.withValues(alpha: 0.1),
      blurRadius: 20,
      offset: const Offset(0, 8),
    ),
  ],
);

💡 Real-World Examples

🔐 Authentication Flow

class AuthController {
  static Future<void> loginUser(String email, String password) async {
    // Show loading
    CustomQuickAlert.loading(
      title: 'Signing In',
      message: 'Authenticating your credentials...',
    );

    try {
      // Simulate API call
      await Future.delayed(Duration(seconds: 2));
      CustomQuickAlert.dismiss(); // Close loading
      
      if (email == 'user@example.com' && password == 'password') {
        // Show success
        CustomQuickAlert.success(
          title: 'Welcome Back!',
          message: 'You have been successfully signed in.',
          onConfirm: () {
            Navigator.pushReplacementNamed(
              navigatorKey.currentContext!, 
              '/dashboard'
            );
          },
        );
      } else {
        // Show error
        CustomQuickAlert.error(
          title: 'Login Failed',
          message: 'Invalid email or password. Please try again.',
          confirmText: 'Try Again',
        );
      }
    } catch (e) {
      CustomQuickAlert.dismiss();
      CustomQuickAlert.error(
        title: 'Connection Error',
        message: 'Unable to connect to server. Please check your internet connection.',
        confirmText: 'Retry',
        showCancel: true,
        onConfirm: () => loginUser(email, password), // Retry
      );
    }
  }
}

📁 File Upload with Progress

class FileUploadService {
  static Future<void> uploadFile() async {
    // Show loading with custom message
    CustomQuickAlert.loading(
      title: 'Uploading File...',
      message: 'Your file is being uploaded. Please don\'t close the app.',
    );
    
    try {
      // Simulate file upload progress
      await Future.delayed(Duration(seconds: 3));
      
      CustomQuickAlert.dismiss();
      
      CustomQuickAlert.success(
        title: 'Upload Complete!',
        message: 'Your file has been uploaded successfully.',
        confirmText: 'View File',
        showCancel: true,
        cancelText: 'Close',
        onConfirm: () {
          // Navigate to file viewer
          print('Opening file viewer...');
        },
      );
    } catch (e) {
      CustomQuickAlert.dismiss();
      
      CustomQuickAlert.error(
        title: 'Upload Failed',
        message: 'Failed to upload file. Would you like to try again?',
        confirmText: 'Retry',
        showCancel: true,
        cancelText: 'Cancel',
        onConfirm: () => uploadFile(), // Retry upload
      );
    }
  }
}

🗑️ Data Deletion Confirmation

class DataService {
  static void confirmDelete(String itemName, VoidCallback onDelete) {
    CustomQuickAlert.warning(
      title: 'Delete $itemName?',
      message: 'This action cannot be undone. The item will be permanently deleted.',
      confirmText: 'Delete',
      cancelText: 'Cancel',
      showCancel: true,
      confirmBtnColor: Colors.red,
      onConfirm: () {
        // Show loading during deletion
        CustomQuickAlert.loading(
          title: 'Deleting...',
          message: 'Please wait while we delete the item.',
        );
        
        Future.delayed(Duration(seconds: 1), () {
          CustomQuickAlert.dismiss();
          
          // Perform deletion
          onDelete();
          
          CustomQuickAlert.success(
            title: 'Deleted Successfully',
            message: '$itemName has been deleted.',
            autoCloseDuration: Duration(seconds: 2),
            showConfirm: false,
          );
        });
      },
    );
  }
}

// Usage
DataService.confirmDelete('My Document', () {
  print('Document deleted from database');
});

🌐 Network Status Handler

class NetworkStatusHandler {
  static void showNetworkError() {
    CustomQuickAlert.error(
      title: 'No Internet Connection',
      message: 'Please check your internet connection and try again.',
      confirmText: 'Retry',
      showCancel: true,
      cancelText: 'Offline Mode',
      position: QuickAlertPosition.top,
      onConfirm: () {
        // Retry network operation
        checkConnection();
      },
      onCancel: () {
        // Switch to offline mode
        enableOfflineMode();
      },
    );
  }
  
  static void showConnectionRestored() {
    CustomQuickAlert.success(
      title: 'Connection Restored',
      message: 'You\'re back online! Syncing your data...',
      position: QuickAlertPosition.top,
      autoCloseDuration: Duration(seconds: 3),
      showConfirm: false,
    );
  }
  
  static void checkConnection() {
    // Network check logic
  }
  
  static void enableOfflineMode() {
    // Offline mode logic
  }
}

📝 Form Validation

class FormValidator {
  static void validateAndSubmit(Map<String, dynamic> formData) {
    List<String> errors = [];
    
    if (formData['name']?.isEmpty ?? true) {
      errors.add('Name is required');
    }
    if (formData['email']?.isEmpty ?? true) {
      errors.add('Email is required');
    }
    
    if (errors.isNotEmpty) {
      CustomQuickAlert.warning(
        title: 'Form Validation Error',
        message: 'Please fix the following errors:\n\n${errors.join('\n')}',
        confirmText: 'Fix Errors',
      );
      return;
    }
    
    // If validation passes
    CustomQuickAlert.loading(
      title: 'Submitting Form...',
      message: 'Please wait while we process your information.',
    );
    
    Future.delayed(Duration(seconds: 2), () {
      CustomQuickAlert.dismiss();
      
      CustomQuickAlert.success(
        title: 'Form Submitted!',
        message: 'Thank you! Your information has been submitted successfully.',
        onConfirm: () {
          Navigator.pop(navigatorKey.currentContext!);
        },
      );
    });
  }
}
      
      // Navigate to home
      Navigator.pushReplacementNamed(context, '/home');
      
    } catch (e) {
      CustomQuickAlert.dismiss(); // Close loading
      
      // Show error
      CustomQuickAlert.error(
        title: 'Login Failed',
        message: e.toString(),
        confirmText: 'Try Again',
        onConfirm: () => _showLoginDialog(),
      );
    }
  }

  static void logout() {
    CustomQuickAlert.confirm(
      title: 'Sign Out',
      message: 'Are you sure you want to sign out?',
      confirmText: 'Sign Out',
      cancelText: 'Cancel',
      showCancel: true,
      onConfirm: () async {
        await AuthService.logout();
        CustomQuickAlert.success(
          title: 'Signed Out',
          message: 'You have been successfully signed out.',
        );
      },
    );
  }
}

🛒 E-commerce Actions

class ShoppingController {
  static void addToCart(Product product) {
    CustomQuickAlert.confirm(
      title: 'Add to Cart',
      message: 'Add ${product.name} to your shopping cart?',
      confirmText: 'Add to Cart',
      cancelText: 'Cancel',
      showCancel: true,
      position: QuickAlertPosition.bottom,
      onConfirm: () {
        CartService.addItem(product);
        CustomQuickAlert.success(
          title: 'Added to Cart',
          message: '${product.name} has been added to your cart.',
          autoCloseDuration: const Duration(seconds: 2),
        );
      },
    );
  }

  static void removeFromCart(CartItem item) {
    CustomQuickAlert.warning(
      title: 'Remove Item',
      message: 'Remove ${item.product.name} from cart?',
      confirmText: 'Remove',
      cancelText: 'Keep',
      showCancel: true,
      onConfirm: () {
        CartService.removeItem(item.id);
        CustomQuickAlert.info(
          title: 'Item Removed',
          message: 'Item has been removed from your cart.',
        );
      },
    );
  }

  static Future<void> processPayment(double amount) async {
    CustomQuickAlert.loading(
      title: 'Processing Payment',
      message: 'Please wait while we process your payment...',
    );

    try {
      await PaymentService.charge(amount);
      CustomQuickAlert.dismiss();
      
      CustomQuickAlert.success(
        title: 'Payment Successful!',
        message: 'Your order has been confirmed and will be shipped soon.',
        confirmText: 'View Order',
        onConfirm: () => Navigator.pushNamed(context, '/orders'),
      );
    } catch (e) {
      CustomQuickAlert.dismiss();
      
      CustomQuickAlert.error(
        title: 'Payment Failed',
        message: 'Unable to process payment. Please try again.',
        confirmText: 'Retry',
        onConfirm: () => processPayment(amount),
      );
    }
  }
}

📱 App Updates & Maintenance

class AppUpdateController {
  static Future<void> checkForUpdates() async {
    CustomQuickAlert.loading(
      title: 'Checking for Updates',
      message: 'Looking for new version...',
    );

    final updateInfo = await UpdateService.checkForUpdates();
    CustomQuickAlert.dismiss();

    if (updateInfo.hasUpdate) {
      CustomQuickAlert.info(
        title: 'Update Available',
        message: 'Version ${updateInfo.version} is available with new features and improvements.',
        confirmText: 'Update Now',
        cancelText: 'Later',
        showCancel: true,
        onConfirm: () => _downloadUpdate(updateInfo),
      );
    } else {
      CustomQuickAlert.success(
        title: 'Up to Date',
        message: 'You are using the latest version of the app.',
        autoCloseDuration: const Duration(seconds: 2),
      );
    }
  }

  static Future<void> _downloadUpdate(UpdateInfo info) async {
    CustomQuickAlert.loading(
      title: 'Downloading Update',
      message: 'Downloading version ${info.version}...',
    );

    try {
      await UpdateService.downloadAndInstall(info);
      CustomQuickAlert.dismiss();
      
      CustomQuickAlert.success(
        title: 'Update Complete',
        message: 'App will restart to apply the update.',
        confirmText: 'Restart',
        onConfirm: () => UpdateService.restartApp(),
      );
    } catch (e) {
      CustomQuickAlert.dismiss();
      
      CustomQuickAlert.error(
        title: 'Update Failed',
        message: 'Failed to download update. Please try again.',
        confirmText: 'Retry',
        onConfirm: () => _downloadUpdate(info),
      );
    }
  }
}

🔧 Advanced Usage

🎨 Custom Theme System

// Create reusable theme configurations
class AppAlerts {
  // Success theme
  static void showSuccess(String title, String message) {
    CustomQuickAlert.success(
      title: title,
      message: message,
      backgroundColor: const Color(0xFFF0FDF4),
      titleColor: const Color(0xFF16A34A),
      messageColor: const Color(0xFF166534),
      confirmBtnColor: const Color(0xFF22C55E),
      customShadows: [
        BoxShadow(
          color: Colors.green.withValues(alpha: 0.1),
          blurRadius: 20,
          offset: const Offset(0, 8),
        ),
      ],
    );
  }

  // Error theme
  static void showError(String title, String message) {
    CustomQuickAlert.error(
      title: title,
      message: message,
      backgroundColor: const Color(0xFFFEF2F2),
      titleColor: const Color(0xFFDC2626),
      messageColor: const Color(0xFF991B1B),
      confirmBtnColor: const Color(0xFFEF4444),
      customShadows: [
        BoxShadow(
          color: Colors.red.withValues(alpha: 0.1),
          blurRadius: 20,
          offset: const Offset(0, 8),
        ),
      ],
    );
  }

  // Dark theme variant
  static void showDarkThemeAlert(String title, String message) {
    CustomQuickAlert.info(
      title: title,
      message: message,
      backgroundColor: const Color(0xFF1F2937),
      titleColor: const Color(0xFFF9FAFB),
      messageColor: const Color(0xFFD1D5DB),
      confirmBtnColor: const Color(0xFF3B82F6),
      confirmTextColor: Colors.white,
      borderRadius: 12.0,
    );
  }
}

🎯 Custom Lottie Animations

// Using custom Lottie animations
CustomQuickAlert.custom(
  title: 'Custom Animation',
  message: 'This alert uses a custom Lottie animation.',
  lottieAsset: 'assets/animations/my_custom_animation.json',
  confirmText: 'Awesome!',
  backgroundColor: Colors.purple.shade50,
  titleColor: Colors.purple.shade800,
  confirmBtnColor: Colors.purple.shade600,
);

// Custom animation with callbacks
CustomQuickAlert.custom(
  title: 'Achievement Unlocked!',
  message: 'You have completed all tasks.',
  lottieAsset: 'assets/animations/achievement.json',
  confirmText: 'Collect Reward',
  onConfirm: () {
    // Handle reward collection
    RewardService.collectReward();
  },
);

⚡ Performance Optimization

class AlertManager {
  static Timer? _debounceTimer;
  static final Queue<AlertConfig> _alertQueue = Queue<AlertConfig>();
  static bool _isShowingAlert = false;
  
  // Debounced alerts to prevent spam
  static void showDebouncedSuccess(String title, String message) {
    _debounceTimer?.cancel();
    _debounceTimer = Timer(const Duration(milliseconds: 300), () {
      CustomQuickAlert.success(title: title, message: message);
    });
  }
  
  // Queue management for multiple alerts
  static void queueAlert(AlertConfig config) {
    _alertQueue.add(config);
    _processQueue();
  }
  
  static void _processQueue() {
    if (_isShowingAlert || _alertQueue.isEmpty) return;
    
    _isShowingAlert = true;
    final config = _alertQueue.removeFirst();
    
    // Show alert and process next after completion
    config.show().then((_) {
      _isShowingAlert = false;
      _processQueue();
    });
  }

  // Memory cleanup
  static void dispose() {
    _debounceTimer?.cancel();
    _alertQueue.clear();
    _isShowingAlert = false;
  }
}

class AlertConfig {
  final String title;
  final String message;
  final QuickAlertType type;
  
  AlertConfig({required this.title, required this.message, required this.type});
  
  Future<void> show() async {
    switch (type) {
      case QuickAlertType.success:
        return CustomQuickAlert.success(title: title, message: message);
      case QuickAlertType.error:
        return CustomQuickAlert.error(title: title, message: message);
      // ... other types
    }
  }
}

📚 Migration Guide

🔄 Upgrading from v1.x to v2.x

dependencies:
  custom_quick_alert: ^2.1.1  # Update version

// Add to main.dart
final GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();

void main() {
  runApp(const MyApp());
  CustomQuickAlert.initialize(navigatorKey);
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      navigatorKey: navigatorKey, // Add this
      home: const HomePage(),
    );
  }
}

QuickAlert.show(
  context: context,
  type: QuickAlertType.success,
  title: 'Success!',
  text: 'Operation completed',
);

CustomQuickAlert.success(
  title: 'Success!',
  message: 'Operation completed',
);

🌍 Platform Support

🔍 Troubleshooting

MaterialApp(
  navigatorKey: navigatorKey, // Ensure this is set
  // ... other properties
)

flutter:
  assets:
    - assets/animations/

CustomQuickAlert.success(
  backgroundColor: Colors.green.shade50,  // Dialog background
  titleColor: Colors.green.shade800,     // Title color
  messageColor: Colors.green.shade600,   // Message color
);

// Always dismiss loading alerts
CustomQuickAlert.loading(title: 'Loading...');
// ... async operation
CustomQuickAlert.dismiss(); // Important!

// Use debouncing or queue management
AlertManager.showDebouncedSuccess('Title', 'Message');

📊 Performance Metrics

🤝 Contributing

We welcome contributions! Here's how you can help:

🐛 Bug Reports

1. Check existing issues
2. Use the bug report template
3. Include reproduction steps and system info

✨ Feature Requests

1. Search existing requests
2. Use the feature request template
3. Explain the use case and benefits

🔧 Development Setup

# Clone repository
git clone https://github.com/ariyanshiputech/custom_quick_alert.git
cd custom_quick_alert

# Install dependencies
flutter pub get

# Run tests
flutter test

# Run example app
cd example
flutter run

📋 Pull Request Process

1. Fork the repository
2. Create feature branch (git checkout -b feature/amazing-feature)
3. Follow coding standards
4. Add tests for new features
5. Update documentation
6. Commit changes (git commit -m 'Add amazing feature')
7. Push to branch (git push origin feature/amazing-feature)
8. Open a Pull Request

📈 Roadmap

🎯 Upcoming Features

• Theme Presets - Pre-built professional themes
• Sound Effects - Optional audio feedback
• Accessibility - Enhanced screen reader support
• Gesture Support - Swipe to dismiss
• Queue Management - Advanced alert queuing
• Analytics - Usage tracking and insights

🚀 Long-term Goals

• Flutter 4.0 - Next major Flutter version support
• Advanced Animations - More animation options
• Plugin System - Extensible architecture
• Cloud Themes - Remote theme configuration

📄 License

MIT License

Copyright (c) 2024 Ariyan Shipu Technology

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

💝 Support & Sponsorship

📚 Documentation & Resources