toastr_flutter 1.0.0+1

A highly customizable Flutter package for displaying beautiful toast notifications with animations, multiple types, and flexible positioning.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.0.0+1 - 2025-09-02

Added

• 📱 Responsive design support: Optimized layouts for mobile, tablet, and desktop devices
• 🎯 Device-specific sizing:
  • Mobile: Compact layout with appropriate touch targets
  • Tablet: Medium-sized notifications with enhanced readability
  • Desktop: Larger notifications with increased text and icon sizes
• 🔧 Smart layout adjustments:
  • Dynamic width constraints based on screen size
  • Responsive margins and padding
  • Scalable font sizes for better readability
  • Adaptive icon sizes (20px mobile, 24px tablet, 26px desktop)
  • Responsive close button sizing

Enhanced

• 🎨 Improved visual hierarchy: Better text scaling across different devices
• 📐 Adaptive spacing: Container padding and margins adjust based on screen size
• 🎯 Better touch targets: Larger interactive elements on mobile devices
• 🖥️ Desktop optimization: Enhanced hover effects and larger content for desktop users

Technical Improvements

• Added ResponsiveDimensions class for better dimension management
• Improved breakpoint logic (Mobile: <768px, Tablet: 768-1024px, Desktop: >1024px)
• Enhanced positioning service with responsive margins
• Better adaptation to high DPI displays

1.0.0 - 2025-09-02

Added

• 🎉 Initial release of the Toastr Flutter package (published as toastr_flutter)
• ✨ Four notification types: success, error, warning, and info with predefined colors and icons
• 🎨 Multiple positioning options: topLeft, topCenter, topRight, bottomLeft, bottomCenter, bottomRight, and center
• 🎭 Rich animation support:
  • Show animations: fadeIn, slideDown, slideUp, slideLeft, slideRight, show
  • Hide animations: fadeOut, slideUp, slideDown, slideLeft, slideRight, hide
  • Customizable easing curves for both show and hide animations
• ⚙️ Comprehensive configuration options:
  • Custom titles and messages
  • Configurable duration and extended timeout
  • Dismissible notifications with tap-to-dismiss
  • Optional close button
  • Custom icons and colors (background and text)
  • Progress bar support
  • Duplicate prevention system
• 🔒 Security features:
  • Input validation and sanitization
  • Rate limiting to prevent spam
  • Maximum active notifications limit
  • Security event logging
• 🎯 Easy-to-use API:
  • Static helper methods: ToastrHelper.success(), ToastrHelper.error(), etc.
  • Full configuration support via ToastrConfig class
  • Global configuration management
  • Service-based architecture with ToastrService
• 🎪 Interactive features:
  • Hover effects with pause-on-hover functionality
  • Auto-dismiss with configurable timing
  • Manual dismissal support
  • Clear all notifications functionality
• 📱 Flutter integration:
  • Overlay-based rendering for optimal performance
  • Material Design compliance
  • Support for Flutter 3.0+ and Dart 3.9+
• 🧪 Comprehensive testing:
  • Unit tests for core functionality
  • Security validation tests
  • Error handling tests
• 📚 Complete documentation:
  • Detailed README with examples
  • API reference documentation
  • Working example application
• 🔧 Developer experience:
  • Type-safe configuration
  • Null-safety support
  • Lint-compliant code
  • Professional project structure

Technical Details

• Minimum Flutter version: 3.0.0
• Minimum Dart SDK: 3.9.0
• Dependencies: Only Flutter SDK (no external dependencies)
• Platform support: All Flutter-supported platforms

Example Usage

// Basic usage
ToastrHelper.success('Operation completed successfully!');
ToastrHelper.error('Something went wrong!');
ToastrHelper.warning('Please check your input');
ToastrHelper.info('Here is some useful information');

// Advanced usage with custom configuration
ToastrHelper.custom(
  ToastrConfig(
    type: ToastrType.success,
    message: 'Custom notification',
    title: 'Success',
    duration: Duration(seconds: 5),
    position: ToastrPosition.bottomCenter,
    showMethod: ToastrShowMethod.slideUp,
    hideMethod: ToastrHideMethod.fadeOut,
    showProgressBar: true,
    showCloseButton: true,
  ),
);

Documentation

• Comprehensive README with installation guide, usage examples, and API reference
• Working example application demonstrating all features
• Complete API documentation for all public classes and methods

---

[Unreleased]

Planned Features

• Custom animation curves support
• Sound effects for notifications
• Notification queuing system
• Theme integration with Flutter's ThemeData
• Accessibility improvements (screen reader support)
• Custom notification layouts
• Notification history/log
• Analytics and usage tracking options

---

Note: This changelog follows the Keep a Changelog format and Semantic Versioning principles.