flutter_log_handler 1.0.0

Enterprise-grade Flutter logging with console/file logs, crash capture, API interception, and built-in log viewer UI.

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

⚡ Stable Release

This is the first stable release of flutter_log_handler with Hive-based logging, advanced search, and enterprise-ready export features.

🚀 Major Enhancements

• Hive-based lazy log storage with optimized pagination (500k+ safe).
• Export & Share enhancements:
  • Export logs as TXT, JSON, PDF, or compressed GZIP.
  • Export today only logs option.
  • Progress loader during log export.
  • Customizable export bottom sheet and formats.
• Delete logs improvements:
  • Level-based or complete log deletion.
  • Confirmation dialog for safety.
  • Bottom sheet selection for log levels.
• Enterprise-grade search & filtering:
  • Support for log level filter + search combined.
  • High-performance pagination and streaming.
• Strong null-safety handling across models, service, and UI.
• Optimized retention mechanism to auto-clean old logs.

🛠 Improvements

• Improved performance:
  • Log loading and filtering optimized for 500k+ logs.
  • Batched export writes for large logs.
• PDF export fully paginated for large datasets.
• JSON export formatted with summary + logs array.
• Minor internal optimizations and code cleanup.
• Enhanced README and documentation for stable API.

---

0.1.0

⚠️ Breaking Changes

• Replaced previous LogService with Hive-based LogServiceHive for persistent logging.
• Renamed MyLogScreen → LogViewerScreen
  • Update all imports and widget references accordingly.
• Updated export menu structure to use:
  • enableCustomExportMenu
  • allowedExportFormats
• LogScreen constructor updated with new action button controls:
  • enableShareButton
  • enableRefreshButton
  • enableClearButton
• Internal filtering engine refactored (custom filtering logic may require minor integration updates)

---

🚀 Major Enhancements

• Added animated log level filter chips
• Added collapsible search bar with smooth animation
• Implemented advanced log search & filtering engine
• Added Copy Log button inside each log card
• Improved route tracking display in log subtitle
• Added export progress loader
• Added log loading indicator
• Added enterprise-grade export formats:
  • Export as JSON
  • Export as PDF
  • Export grouped by date
  • Export only today logs
• Added customizable export bottom sheet
• Improved filtering and rendering performance

---

🛠 Improvements

• Cleaner production-ready UI architecture
• Better separation of filtering logic
• Improved ExpansionTile rendering
• Enhanced search performance
• Improved sensitive data masking
• Stronger null-safety handling
• Minor internal optimizations and fixes

---

0.0.5

🚀 Enhancements

• Added custom AppBar customization in LogScreen:
  • appBarColor to change AppBar background
  • centerTitle to toggle title alignment
  • Custom icons for leading, refresh, share, and delete actions
  • Custom callbacks for AppBar icon taps
• Added customizable delete confirmation dialog:
  • deleteDialogTitle, deleteDialogMessage, deleteDialogConfirmText, deleteDialogCancelText
  • Fully supports custom button actions
• Added enhanced log list display:
  • Shows log timestamp + route
  • Pull-to-refresh for logs
  • Filter logs by level with horizontal chips
  • Selectable stack trace in expanded log card
• Improved log sharing with customizable share action
• Updated color handling using .withValues() for consistent opacity

🛠 Improvements

• Refactored internal LogScreen UI for flexible customization
• Improved performance of log filtering, refresh, and sharing
• Enhanced null safety in log models and UI
• Fixed sensitive data masking to ensure keys like password, token, apiKey are hidden
• Minor bug fixes and code cleanup

---

0.0.4

🚀 Enhancements

• Added customizable LogScreen UI with:
  • Custom title, no-logs message, and log colors per level
  • Optional chip indicators for log levels
  • Customizable delete confirmation dialog text
  • Customizable date format for log timestamps
• Added pull-to-refresh support for LogScreen
• Added share logs feature using share_plus
• Improved filter chips with horizontal scroll and better color indicators
• Added expanded error & info display with selectable stack trace
• Updated color handling to use .withValues() instead of deprecated .withOpacity()

🛠 Improvements

• Refactored internal log UI for modern Flutter best practices
• Improved performance of log filtering and refresh
• Enhanced null safety and resilience in log encoding/decoding
• Updated clear logs confirmation flow with improved UX
• Minor bug fixes and code cleanup

---

0.0.3

🚀 Enhancements

• Added automatic crash tagging (device info, platform metadata, build flavor support)
• Added API endpoint tagging in error logs
• Improved structured log model
• Improved stack trace handling
• Enhanced API interceptor logging structure
• Improved sensitive data masking
• Enterprise branding improvements
• SEO optimized README documentation

🛠 Improvements

• Performance refinements
• Improved log persistence reliability
• Refactored internal log encoding/decoding
• Enhanced production safety for logging flow

---

0.0.2

• Added fileName and directoryName configuration
• Added getLogs() method
• Improved log loading mechanism
• Enhanced README documentation
• Improved MIT License
• Production-ready refinements

---

0.0.1

• Initial release of flutter_log_handler
• Configurable log storage
• Console logging support
• File logging support
• Built-in LogScreen UI
• Crash wrapper support
• API interceptor support**