Added #

• 🎯 Class-Based Filtering - New "Classes" button in logger history page for filtering logs by class names
• 📱 Class Filter Bottom Sheet - Dedicated bottom sheet for class selection with multi-select functionality
• 🔄 Dual View Modes - Toggle between list view and compact chip view for class selection
• 📊 Class Statistics - Shows log count per class with visual indicators
• 🎨 Smart Button Styling - Classes button appears grey when no classes are available, purple when active
• 🔍 Class Search - Search and filter through available classes in the bottom sheet
• 📋 Selected Classes Display - Horizontal chip list showing currently selected classes
• 💡 Educational Content - Informative message explaining class filtering when no classes exist

Enhanced #

• 🎛️ Advanced Filtering - Expanded filtering capabilities beyond log levels and API methods
• 📱 Better UX - Improved filter section with more granular control options
• 🎯 Source-Aware Filtering - Class filtering only applies to general logs, respects main source filters

Technical #

• 🏗️ FilterManager Enhancement - Added selectedClasses state management and class filtering logic
• 📊 LogDataService Updates - New methods for extracting and counting classes from logs
• 🎨 UI Components - New ClassFilterBottomSheet and ClassChipTile widgets with responsive design
• 📱 Material Design 3 - Full theming support for the new filter components

Fixed #

• 🔧 Source File Path Display - Fixed incorrect source file path in logger history page showing logging_using_logger.dart instead of actual calling file (e.g., api_demo_page.dart)
• 📍 Stack Trace Filtering - Improved stack trace filtering to properly exclude internal logger files and show correct source locations

Added #

• 🎛️ Settings Modal - Added comprehensive settings modal accessible via app bar settings icon
• 🔄 Circular Buffer Configuration - New enableCircularBuffer parameter in AwesomeLoggerConfig for controlling log replacement behavior
• ⚙️ Runtime Configuration - All logger settings can now be modified at runtime through the settings modal
• 📊 Dynamic Max Log Entries - Real-time adjustment of maximum log entries limit
• 🎨 Console Output Toggles - Runtime toggles for file paths, emojis, and colors in console output
• 📈 Current Stats Display - Shows current number of stored logs in settings modal

Changed #

• 🚀 Improved UX - Moved configuration from inline UI to dedicated settings modal for cleaner interface
• 📱 Better Mobile Experience - Settings modal handles keyboard and screen sizes gracefully
• 🎯 Enhanced Developer Experience - Immediate feedback on configuration changes

Technical #

• 🏗️ Modal Architecture - Implemented StatefulBuilder for proper state management in bottom sheet
• 📱 Keyboard Handling - Proper keyboard dismissal and viewport adjustments
• 🎨 Theme Integration - Full Material 3 theming support in settings modal

• removed bloc dependency

• fixes to support older flutter versions

Removed #

• 🗑️ Shake Package Dependency - Removed shake package (^3.0.0) from dependencies
• 🤳 Shake-to-Toggle Functionality - Removed shake-to-show/hide floating button feature
• 🤳 Shake-to-Enable Functionality - Removed shake-to-enable logger when disabled feature
• ⚙️ Shake Configuration Options - Removed enableShakeToShowHideFloatingButton, enableShakeToEnableLogger, and shakeSensitivity from FloatingLoggerConfig

Changed #

• 📖 Updated Documentation - Removed all shake-related references from README.md and example documentation
• 🧹 Code Cleanup - Simplified floating logger configuration without shake-related parameters
• 📱 Example App - Updated example app to use simplified configuration without shake features

Technical #

• 🏗️ Reduced Dependencies - Smaller package footprint by removing shake dependency
• 🎯 Simplified Configuration - Cleaner API surface without shake-related configuration options
• 📦 Package Size Optimization - Reduced overall package size and complexity

• updated README.md with new screenshots

🎉 Major UI Overhaul - Unified Logger Experience #

This release introduces a completely redesigned logging experience with a unified interface that combines both general and API logs in one seamless view.

Added #

• 🎯 Unified Logger Interface - New AwesomeLoggerHistoryPage combines general and API logs in chronological order
• 🔍 Advanced Filtering System - Expandable filter sections with smart sub-filters for logger levels and API methods
• 📊 Intelligent Statistics - Real-time statistics with clickable filtering capabilities
• 🎨 Enhanced Visual Design - Modern card-based layout with improved readability and navigation
• ⚡ Smart Filter Management - Collapsible filter sections with active filter indicators
• 🔄 Improved Sorting - Better sort toggle with visual feedback and intuitive controls

Changed #

• 🚀 Simplified API - Removed separate tab-based UI in favor of unified chronological view
• 📱 Better Mobile Experience - Optimized layout for all screen sizes with responsive design
• 🎯 Streamlined Navigation - Single entry point for all logging functionality
• 📖 Updated Documentation - README and examples now reflect the new unified approach

Removed #

• ⚠️ Breaking Change: Removed LoggerHistoryPage - use AwesomeLoggerHistoryPage instead
• ⚠️ Breaking Change: Removed separate ApiLogsTab and GeneralLogsTab widgets
• 🧹 Code Cleanup - Removed unused filter chip components and redundant UI files

Fixed #

• 🔧 Flutter Analyze Issues - Fixed all deprecated withOpacity usage, replaced with withValues
• 🐛 Unused Variable Warnings - Removed unused local variables in statistics calculation
• 📝 Code Style Issues - Added proper curly braces and removed unnecessary this. qualifiers

Technical #

• 🏗️ Unified Architecture - Single page handles all log types with smart filtering
• 📊 Performance Improvements - More efficient log rendering and filtering
• 🎯 Better State Management - Improved filter state handling and UI updates
• 🧪 Enhanced Testing - All tests pass with zero analysis issues

Migration Guide #

// Old way (no longer available)
Navigator.push(context, MaterialPageRoute(
  builder: (context) => const LoggerHistoryPage(),
));

// New way (recommended)
Navigator.push(context, MaterialPageRoute(
  builder: (context) => const AwesomeLoggerHistoryPage(),
));

• made sort logs toggle button to api and general logs tabs more intuitive and user-friendly

• updated README.md for better clarity, readability and formatting

• updated example app pubspec.yaml with sdk: ">=3.0.0 <4.0.0"

• updated README.md to show screenshots properly

Improved README Documentation #

• 📖 Enhanced README Documentation - Complete overhaul of README with professional formatting and responsive design
• ⚡ Easiest Setup Guide - Added ultra-simple 2-line setup instructions with MaterialApp example
• 📱 Mobile-Responsive Screenshots - Images now stack vertically on mobile devices with CSS media queries
• 🎯 Professional Layout - Replaced centered table layouts with clean, left-aligned professional sections
• 📋 Comprehensive Logging Guides - Detailed explanations for both API logs and general logs tabs
• ✨ Enhanced Features Table - Added long press floating button feature with 4 detailed interaction methods
• 🎨 Modern Badges and Styling - Updated to for-the-badge style badges with Flutter/Dart technology indicators
• 📚 Improved Navigation - Added collapsible table of contents and better section organization
• 🔧 Better Code Examples - More practical examples with real-world usage patterns and best practices

Added #

• 💬 Simple Error Display - Shows navigation error directly in the floating logger widget when navigation fails
• 📖 Better Developer Experience - Navigation errors now show both console output and visual in-widget message

Fixed #

• 🔧 Navigation Context Issues - Simplified error handling with reliable in-widget display and console output
• 🎯 Error Visibility - Users will always see navigation errors with clear instructions and code examples

Added #

• 💬 User-Friendly Error Dialog - Added helpful dialog that appears when navigation fails, showing step-by-step solution
• 📖 Better Developer Experience - Navigation errors now show both console output and visual dialog with code examples

Improved #

• 🎯 Error Handling - Enhanced navigation error reporting with clear instructions and selectable documentation link

Fixed #

• 🔧 Navigator Key Handling - Improved navigation logic to properly handle cases where navigatorKey.currentState is null
• 📱 Navigation Robustness - Better fallback mechanism when provided navigator key is not ready yet

Fixed #

• 🔧 Flutter Compatibility - Replaced Color.withValues() with Color.withOpacity() for better compatibility with older Flutter versions
• 📱 iOS Build Fix - Fixed Xcode build errors related to undefined withValues method

Fixed #

• 🔧 Path Dependency Compatibility - Changed path dependency from ^1.9.1 to ^1.9.0 to be compatible with Flutter SDK 3.24.5
• 📦 Flutter SDK Compatibility - Fixed version solving issues with flutter_test dependency conflicts

Changed #

• 🔧 Dart SDK Compatibility - Lowered minimum Dart SDK requirement from ^3.8.1 to >=3.0.0 <4.0.0
• 📦 Wider Compatibility - Package now works with Dart SDK 3.0.0 and above, including 3.5.x versions

Fixed #

• 🐛 Dependency Resolution - Fixed version solving issues for projects using Dart SDK < 3.8.1

Changed #

• ✨ Synchronous Methods - Removed unnecessary async/await from visibility and preference methods
• 📊 Better Performance - Visibility methods are now synchronous since they don't perform async operations
• 🎯 Cleaner API - No need for await when checking visibility or toggling

Added #

• 📖 Additional Methods - getSavedPosition(), savePosition(), clearPreferences(), initialize() now available through FlutterAwesomeLogger

## [1.0.0] (2024-10-15)

### 🎉 Major Release - Stable API

This release marks the first stable version of Flutter Awesome Logger with a clean, production-ready API.

### Added
- 🏭 **Factory Pattern Implementation** - Clean access to logger through `FlutterAwesomeLogger.loggingUsingLogger`
- 🎯 **Simplified API** - Single entry point for logger access without exposing internal implementation
- 📖 **Enhanced Documentation** - Updated README with comprehensive factory pattern examples
- 🔧 **Better Encapsulation** - Internal logging classes are no longer directly exposed

### Changed
- 🚀 **New Recommended Usage** - `final logger = FlutterAwesomeLogger.loggingUsingLogger;`
- 📦 **Cleaner Exports** - Only necessary classes and configs are exported
- 📚 **Updated Examples** - All code examples now use the new factory pattern
- 🎨 **Improved Developer Experience** - More intuitive API design

### Technical
- 🏗️ **Static Getter Implementation** - Added static `loggingUsingLogger` getter to `FlutterAwesomeLogger` widget class
- 🧹 **Code Cleanup** - Removed unnecessary factory classes and simplified architecture
- 📊 **Maintainability** - Easier to maintain and extend in future versions

### Migration Guide
If you were using the logger directly:
```dart
// Old way (still works but not recommended)
import 'package:flutter_awesome_logger/src/core/logging_using_logger.dart';
final logger = LoggingUsingLogger();

// New way (recommended)
import 'package:flutter_awesome_logger/flutter_awesome_logger.dart';
final logger = FlutterAwesomeLogger.loggingUsingLogger;

All existing functionality remains the same - only the access pattern has been improved.

Added #

• 🤳 Shake to Enable Logger - Shake your device to enable the entire logger system when it's disabled (perfect for production builds)
• 🎯 Dual Shake Detection System - Separate detectors for toggle visibility vs enable logger functionality
• 🏗️ Smart State Management - Automatic switching between shake detectors based on logger state

Changed #

• 🔄 Updated Shake Package - Upgraded to shake ^3.0.0 with improved callback signatures
• 📝 Clearer Property Names - Renamed enableShakeToToggle to enableShakeToShowHideFloatingButton and enableShakeToEnable to enableShakeToEnableLogger
• 🎨 Enhanced Configuration - More descriptive parameter names for better developer experience

Fixed #

• 🐛 Flutter Analyze Issues - Fixed all linting errors and warnings
• 🔧 Callback Type Compatibility - Updated shake detector callbacks to match new package API
• 📖 Documentation Updates - Corrected interceptor class name and updated version references

Technical #

• 🏗️ Proper Resource Management - Only one shake detector active at a time for optimal performance
• 🎯 Type Safety - Improved type checking and eliminated unnecessary type assertions
• 📊 Code Quality - All Flutter analyze checks pass with zero issues

Added #

• 🎯 Shake to Toggle - Shake your device to show/hide the floating logger button(Only active when logger is enabled)

Added #

• ⏸️ Pause/Resume Logging - Global pause state that temporarily stops all logging (console output and storage)
• 🎯 Visual Pause Indicators - Floating button changes color/icon when logging is paused, plus banner in logger history
• 🎮 Pause Controls - Long press floating button opens options menu with pause/resume, plus dedicated button in app bar
• 🔄 Async Logger Initialization - enabled parameter now accepts FutureOr<bool> for conditional initialization
• 🏗️ Simplified API - Removed unnecessary storeLogs and autoInitialize parameters

Changed #

• 🚀 Unified Control - Single enabled parameter now controls both floating logger visibility AND log storage
• 📱 Enhanced Floating Logger - Better visual feedback and more intuitive controls
• 🎨 Improved UI - Pause banner in logger history page with clear messaging and quick resume action
• 📖 Updated Documentation - Cleaner examples and better explanations of async capabilities

Fixed #

• 🐛 API Logging Pause Issue - API logs now properly respect the global pause state
• 🎯 Configuration Simplification - Removed confusing parameters that served no real purpose
• 🔧 Code Cleanup - Removed dead code and unnecessary complexity

Breaking Changes #

• ⚠️ AwesomeLoggerConfig.storeLogs removed - Use FlutterAwesomeLogger.enabled to control storage
• ⚠️ FlutterAwesomeLogger.autoInitialize removed - No longer needed
• ⚠️ FlutterAwesomeLogger.enabled type changed - Now accepts FutureOr<bool> instead of bool

Technical #

• 🏗️ Future Resolution - Proper async handling in widget lifecycle
• 🎯 State Management - Improved pause state synchronization across UI components
• 📊 Performance - Cleaner initialization logic and reduced unnecessary operations

• updated dependencies and flutter analysis fixes.

Added #

• added screenshots showcasing the flutter_awesome_logger capabilities to README.md

Added #

• 🎯 Comprehensive unfocus functionality - Search field unfocuses on all interactions
• 🔄 Smart keyboard management - Dismisses keyboard when scrolling, tapping buttons, or interacting with UI
• 📱 Enhanced mobile UX - Follows platform conventions for keyboard behavior

Fixed #

• 🔧 Layout issues in example app - Fixed ParentDataWidget errors and pixel overflow
• 🎨 Responsive design improvements - Better layout handling for different screen sizes
• 📜 SingleChildScrollView integration - Proper scrolling behavior without layout conflicts

Improved #

• ⌨️ Keyboard interaction patterns - Consistent unfocus behavior across all tabs
• 🎯 Touch interactions - All buttons, filters, and controls dismiss keyboard automatically
• 📊 User experience - Smoother navigation and interaction flow

Technical #

• 🏗️ Widget hierarchy fixes - Resolved Expanded/Flex widget constraint issues
• 📱 Scroll view optimization - Proper handling of unbounded height constraints
• 🎯 Event handling - Added FocusScope management to all interactive elements

Changed #

• 🚫 Removed SharedPreferences dependency - No longer stores logs or preferences locally
• 🔄 In-memory storage - Visibility and position are now stored only for current session
• 📦 Lighter package - Reduced dependencies for better performance

Breaking Changes #

• ⚠️ Persistent storage removed - Floating logger position and visibility reset on app restart
• 📱 Session-only state - All preferences are cleared when app closes

• added correct usage of navigator key in debug print and example app

• refactor: rename AwesomeLoggerInterceptor to FlutterAwesomeLoggerDioInterceptor

Added #

• Initial release of Flutter Awesome Logger
• Core logging functionality with configurable options
• Floating logger button with draggable interface
• Automatic API logging with Dio interceptor
• Beautiful UI for viewing log history
• Support for multiple log levels (debug, info, warning, error, verbose)
• Persistent log storage using SharedPreferences
• Search and filter capabilities in log viewer
• Customizable floating button appearance
• Comprehensive configuration options
• Example app demonstrating all features

Features #

• 📱 Floating logger button that stays accessible
• 🌐 Automatic API request/response logging
• 🎨 Modern, clean UI design
• 📊 Multiple log levels with color coding
• 💾 Persistent storage across app sessions
• 🔍 Search and filter functionality
• 🎯 Highly configurable settings
• 📱 Responsive design for all screen sizes