flutter_easy_messages 0.3.0

A customizable Flutter package for toast notifications and snackbars with smooth animations, multiple positions, and flexible behaviors.

0.3.0 Haptic Feedback (Vibration) Support

Features

• Added optional haptic feedback that fires alongside toasts and snackbars
• New HapticFeedbackType enum: lightImpact, mediumImpact, heavyImpact, selectionClick, vibrate
• New per-call parameters on showAppToast() and showAppSnackBar():
  • enableVibration — toggle haptic for an individual message
  • hapticType — choose a specific haptic variant
• New global defaults on EasyMessageConfig: defaultEnableVibration, defaultHapticType (both wired into configure() and reset())
• Automatic haptic intensity derived from MessageType when no explicit type is given:
  • error → heavyImpact
  • warning → mediumImpact
  • success → selectionClick
  • info / unspecified → lightImpact

Implementation Notes

• Uses Flutter's built-in HapticFeedback (package:flutter/services.dart) — no new dependency, no Android VIBRATE permission required
• Silent no-op on platforms without haptic hardware (web, desktop, simulators)
• Fully backward compatible: vibration is off by default, so existing callers see no behavioral change

API Guidance

• Haptic feedback fires from the imperative showAppSnackBar(...) helper. buildAppSnackBar(...) remains a pure widget builder with no side effects, so building the widget yourself and passing it to ScaffoldMessenger.showSnackBar(...) will not fire haptics. Use showAppSnackBar whenever vibration (or the global enableVibration config) should be honored.

Example App

• Added a dedicated Haptic Feedback (Vibration) section: global toggle switch, buttons for each HapticFeedbackType variant, an "Auto (by Type)" demo, and a snackbar + vibration demo
• Switched the existing Success / Error SnackBar demo buttons from buildAppSnackBar + manual ScaffoldMessenger.showSnackBar to showAppSnackBar, so they now honor the global vibration toggle

Documentation

• Added a full 📳 Haptic Feedback (Vibration) section to the main README (per-call usage, global config, MessageType → haptic mapping table, snackbar caveat, testing tip)
• Added matching Section 11: Haptic Feedback (Vibration) to the example README

0.2.0 Enhanced Documentation & Example App Guide

Documentation Improvements

• Completely rewrote main README with 900+ lines of comprehensive documentation
• Created focused pub.dev-optimized package README
• Massively expanded example app README from 447 to 733 lines (64% expansion)
• Added professional badges and formatting throughout
• Added 10+ detailed feature guides with code examples
• Created learning path progression (Beginner → Intermediate → Advanced)
• Added comprehensive testing guide with verification checklist
• Added 19-feature coverage table
• Added troubleshooting section with 7 common issues and solutions
• Included responsive design documentation
• Added implementation architecture guides with code examples

Example App Enhancements

• Transformed basic example README into professional educational guide
• Added detailed feature demonstrations for all 25+ interactive examples
• Included ASCII diagrams for toast positioning (9 options)
• Added real-world use case examples (API error handling, file operations, etc.)
• Created device testing commands for iOS, Android, Web, and Desktop
• Added lifecycle callback documentation
• Added persistence and dismissible toast patterns

0.1.0 Comprehensive Documentation & Example Enhancement

Documentation Improvements

• Added comprehensive dartdoc comments to all public API elements
• Documented 13 static configuration properties in EasyMessageConfig
• Documented configure() method with all 14 parameters
• Added documentation for MessageBehavior, MessageType, and MessagePosition enums
• Documented showAppToast(), buildAppSnackBar(), and internal classes
• Improved documentation coverage from 36% to 90%+

Example App Enhancements

• Significantly expanded example README with comprehensive guide
• Added code usage examples (basic, typed, custom positioned toasts)
• Added global configuration example
• Documented app structure and features
• Added customization guide
• Enhanced feature demonstrations

Pub.dev Quality Improvements

• Now passes documentation quality check (20+ points)
• Example properly detected and documented
• Better API discoverability

0.0.3 Package Validation Fixes

Improvements

• Shortened package description to meet pub.dev guidelines (60-180 characters)
• Added comprehensive example app documentation
• Added dartdoc comments to AnimationDuration class and library
• Improved package validation score

0.0.2 Documentation Fix

Bug Fixes

• Fixed demo GIFs not displaying on pub.dev by using absolute GitHub URLs in README

0.0.1 Initial Release

Features

• Toast notifications with overlay-based rendering
• Snackbar notifications with responsive design
• 4 message types: Error, Success, Info, Warning
• 9 positioning options for toasts
• Smooth entry, exit, and pulse animations
• Queue and replace message behavior modes
• Message deduplication to prevent duplicates
• Responsive layout for mobile, tablet, and desktop
• Global configuration system with per-message overrides
• Customizable animation durations and curves
• Accessibility support with semantic labels
• Complete API exports for advanced usage

Configuration Options

• Toast and snackbar durations
• Border radius customization
• Position and offset control
• Animation timing and scale
• Pulse animation toggle
• Message behavior (replace vs queue)

Out of the Box

• No additional setup required
• Pre-styled message types with icons
• Automatic responsive behavior
• Built-in deduplication logic