Flutter Awesome Logger 🚀

A comprehensive Flutter logging package that makes debugging a breeze! Features a floating logger, automatic API logging with Dio interceptor, and a beautiful UI for viewing logs.

✨ Features

📱 Floating Logger Button - Always accessible debug button that floats over your app (can be disabled)
🤳 Shake to Toggle - Shake your device to show/hide the floating logger button (only when logger is enabled)
🤳 Shake to Enable - Shake your device to enable the logger when it's disabled (perfect for production builds)
🌐 Automatic API Logging - Built-in Dio interceptor for seamless API request/response logging
🎨 Beautiful UI - Clean, modern interface for viewing logs with syntax highlighting
📊 Multiple Log Levels - Support for debug, info, warning, error, and verbose logs
💾 Smart Storage - Logs are stored only when logger is enabled, conserving memory
⏸️ Pause/Resume Logging - Temporarily pause all logging with visual indicators
🔍 Search & Filter - Easily find specific logs with search and filtering capabilities
🎯 Simple Configuration - Single enabled property controls both UI and storage
📱 Responsive Design - Works perfectly on all screen sizes

📸 Screenshots

Floating Logger Button	API Logs View
General Logs View	Log Details

🚀 Getting Started

Installation

Add this to your package's pubspec.yaml file:

dependencies:
  flutter_awesome_logger: ^0.1.9

Then run:

flutter pub get

Basic Usage

Option 1: Auto-Configuration (Recommended - Easiest)

Simply wrap your app with FlutterAwesomeLogger and pass the configuration:

import 'package:flutter/material.dart';
import 'package:flutter_awesome_logger/flutter_awesome_logger.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  // Example: Enable logger after checking some condition
  Future<bool> _shouldEnableLogger() async {
    // Check if we're in debug mode, user preferences, etc.
    await Future.delayed(const Duration(seconds: 2)); // Simulate async check
    return true; // Or false based on your logic
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: FlutterAwesomeLogger(
        enabled: _shouldEnableLogger(), // Can be Future<bool> or bool
        // Auto-configure logger settings
        loggerConfig: const AwesomeLoggerConfig(
          maxLogEntries: 500,
          showFilePaths: true,
          showEmojis: true,
          useColors: true,
        ),
        // Floating logger UI configuration
        config: const FloatingLoggerConfig(
          backgroundColor: Colors.deepPurple,
          icon: Icons.developer_mode,
          showCount: true,
          enableGestures: true,
          autoSnapToEdges: true,
        ),
        child: const YourHomePage(),
      ),
    );
  }
}

Option 2: Manual Configuration (Advanced)

For more control, configure manually in main(). Note: Manual configuration doesn't automatically control log storage - use Option 1 for simpler setup.

import 'package:flutter/material.dart';
import 'package:flutter_awesome_logger/flutter_awesome_logger.dart';

void main() {
  // Manual configuration
  LoggingUsingLogger.configure(
    const AwesomeLoggerConfig(
      maxLogEntries: 500,
      showFilePaths: true,
      showEmojis: true,
      useColors: true,
    ),
  );

  // Manual initialization
  FloatingLoggerManager.initialize();

  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: FlutterAwesomeLogger(
        enabled: true, // Controls both floating logger AND log storage
        // Don't auto-configure since we did it manually
        config: const FloatingLoggerConfig(
          backgroundColor: Colors.deepPurple,
          icon: Icons.developer_mode,
          showCount: true,
          enableGestures: true,
          autoSnapToEdges: true,
        ),
        child: const YourHomePage(),
      ),
    );
  }
}

Start logging:

import 'package:flutter_awesome_logger/flutter_awesome_logger.dart';

// Use the global logger instance
logger.d('Debug message');
logger.i('Info message');
logger.w('Warning message');
logger.e('Error message');
logger.v('Verbose message');

API Logging with Dio

Automatically log all your API requests and responses:

import 'package:dio/dio.dart';
import 'package:flutter_awesome_logger/flutter_awesome_logger.dart';

final dio = Dio();

// Add the awesome logger interceptor
dio.interceptors.add(FlutterAwesomeLoggerDioInterceptor());

// Now all your API calls will be automatically logged!
final response = await dio.get('https://api.example.com/data');

🔧 Configuration Options