🚀 Major Improvements #

Code Quality & Architecture

• Complete code refactoring with improved architecture and organization
• Separation of concerns with dedicated files for models, services, constants, and types
• Clean code principles implementation throughout the codebase
• Better error handling with specific exception types and meaningful error messages
• Enhanced type safety with proper null safety and type annotations
• Improved naming conventions following Dart/Flutter best practices

API Design

• Simplified API with cleaner method signatures
• Better method organization with logical grouping of related functionality
• Consistent naming across all public APIs
• Improved parameter validation with automatic model validation
• Better default values and configuration options

Documentation

• Comprehensive README with detailed examples and best practices
• API documentation with proper DartDoc comments
• Code examples for all major use cases
• Troubleshooting guide for common issues
• Platform-specific documentation explaining capabilities and limitations

✨ New Features #

Enhanced Models

• NotificationModel - Immutable model for standard notifications with validation
• ChatNotificationModel - Extended model for chat-style notifications
• NotificationData - Configuration model for plugin initialization
• BaseNotificationAction - Base class for all notification actions
• NotificationClickAction - Action for notification clicks
• NotificationReplyAction - Action for notification replies
• NotificationMarkReadAction - Action for mark-as-read functionality

App Launch Detection

• appLaunchNotification - Get details about how the app was launched (e.g., from notification click)
• Launch details tracking - Detect if app was opened from notification with payload and action information

Platform Detection

• PlatformUtils - Utility class for platform detection
• SupportedPlatform - Enum for supported platforms
• Platform-specific feature detection for better feature availability checking

Constants Management

• NotificationConstants - Centralized constants for all magic values
• Configurable action IDs and labels
• Validation limits for notification content

🔧 Technical Improvements #

Service Architecture

• Singleton pattern implementation with proper lifecycle management
• Initialization state tracking to prevent usage before initialization
• Resource cleanup with proper dispose methods
• Isolate communication improvements for better reliability
• Background notification handling enhancements

Error Handling

• State validation to ensure service is initialized before use
• Model validation with automatic checks for required fields
• Platform-specific error handling for different notification systems
• Graceful degradation when features are not supported

Performance Optimizations

• Lazy initialization of platform-specific components
• Image caching improvements with better error handling
• Memory management with proper resource disposal
• Efficient stream management for notification actions

📱 Platform Enhancements #

Android

• Improved notification channels with better configuration options
• Enhanced messaging style notifications with better image handling
• Better action button configuration and handling

iOS

• Enhanced permission handling with more granular control
• Improved badge management and sound configuration
• Better critical notification support

Web

• Improved browser notification handling
• Better permission management for web platforms
• Enhanced error handling for unsupported features

Desktop (Windows/macOS/Linux)

• Better system integration for desktop notifications
• Improved notification styling and configuration
• Enhanced error handling for desktop platforms

🛠️ Developer Experience #

Better Examples

• Updated example app with comprehensive demonstration
• Real-world usage patterns showing best practices
• Error handling examples for common scenarios
• Platform-specific examples for different use cases

Code Quality

• Linting compliance with Flutter/Dart best practices
• Consistent code formatting throughout the codebase
• Proper documentation for all public APIs
• Type safety improvements with better null handling

🔄 Breaking Changes #

API Changes

• Renamed classes for better clarity:
  • ShowPluginNotificationModel → NotificationModel
  • PluginNotificationClickAction → NotificationClickAction
  • PluginNotificationReplyAction → NotificationReplyAction
  • PluginNotificationMarkRead → NotificationMarkReadAction
  • NotifierData → NotificationData

Method Changes

• Updated method signatures for better consistency:
  • PlatformNotifier.I.init() → PlatformNotifier.initialize()
  • PlatformNotifier.I.showPluginNotification() → PlatformNotifier.showNotification()
  • PlatformNotifier.I.showChatNotification() → PlatformNotifier.showChatNotification()
  • PlatformNotifier.I.requestPermissions() → PlatformNotifier.requestPermissions()

Stream Changes

• Renamed stream for better clarity:
  • platformNotifierStream → actionStream

🐛 Bug Fixes #

• Fixed initialization issues on some platforms
• Resolved memory leaks in isolate communication
• Fixed image loading errors in chat notifications
• Corrected permission handling on iOS and Android
• Fixed notification cancellation issues
• Resolved background notification handling problems

📚 Documentation #

• Complete API reference with all methods and classes
• Comprehensive examples for all major use cases
• Best practices guide for optimal usage
• Troubleshooting section for common issues
• Platform-specific guides for different platforms
• Migration guide from version 1.x to 2.0

🔧 Dependencies #

• Updated Flutter SDK requirement to 3.10.0+
• Updated Dart SDK requirement to 3.0.0+
• Maintained compatibility with existing dependencies
• No breaking changes in underlying notification libraries

Added #

• Initial release with basic cross-platform notification support
• Support for Android, iOS, Web, Windows, macOS, and Linux
• Chat-style notifications with reply functionality
• Basic permission handling
• Simple notification actions

Known Issues #

• Limited error handling
• Basic documentation
• Inconsistent API design
• Platform-specific limitations not well documented

• make the context optional

• upgrade packages version

Support flutter v 3.24.+

• stable release all platforms supported now!

update packages

support dart 3

• Lazy ask for ios notifications permission

• add payload to PluginNotificationMarkRead class

• initial release.