flutter_log_handler #

Enterprise-Grade Logging, Crash Tracking & API Monitoring Framework for Flutter

A production-ready logging infrastructure built specifically for modern Flutter applications.

Designed for enterprise apps, production builds, QA testing, white-label solutions, and scalable client deployments.

🚀 Why Use flutter_log_handler? #

print() is not production logging.

Modern Flutter apps require:

• ✅ Structured logs (info / warning / error)
• ✅ Persistent local storage with retention policy
• ✅ Crash capture & reporting
• ✅ API request/response tracking with performance monitoring
• ✅ Sensitive data masking (passwords, tokens, API keys)
• ✅ Enterprise-grade log viewer (search, filter, export)
• ✅ Shareable diagnostics for QA and supportExportable logs (TXT / JSON / PDF)

flutter_log_handler delivers a complete observability layer inside your Flutter application.

Lightweight. Configurable. Enterprise-ready.

🎯 Ideal Use Cases #

• Enterprise Flutter apps
• Production & QA builds
• API performance tracking & crash diagnostics
• White-label client deployments
• Large-scale apps requiring structured logs

🔥 Core Features #

📦 Installation #

dependencies:
  flutter_log_handler: ^0.1.0

Then run:

flutter pub get

⚙️ Quick Setup #

Initialize Logger in main() #

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // Start session
  SessionManager.startSession();

  // Set environment tags
  LogContext.setEnvironment(
    flavor: "development",
    appVersion: "0.0.6",
    platform: "android",
  );

  // Initialize Hive log service
  await LogServiceHive.init(
    LogConfig(
      retentionDays: 5,
      enableConsoleLog: true,
      sensitiveKeys: ["password", "token", "apiKey"],
    ),
  );

  runApp(const MyApp());
}

📝 Logging Examples #

Simple Log #

LogServiceHive.to.logEvent(
  message: "User logged in",
  level: LogLevel.info,
);

Log with Stack Trace #

LogServiceHive.to.logEvent(
  message: error.toString(),
  stackTrace: stack.toString(),
  level: LogLevelHive.error,
);

Log with API Endpoint #

LogServiceHive.to.logEvent(
  message: "API Failed",
  level: LogLevel.error,
  stackTrace: stack.toString(),
  apiEndpoint: "/api/login",
);

Fetch Logs #

// Fetch all logs stored in Hive (latest first)
final logs = await LogServiceHive.to.getLogs();

// Example:
for (var log in logs) {
print("[${log.level.name.toUpperCase()}] ${log.timestamp}: ${log.message}");
}

💥 Crash Capture Setup #

await CrashWrapper.initialize(
  logService: LogServiceHive.to,
);

Automatically captures:

• Flutter framework errors
• Unhandled async errors & Zone errors
• Device, platform, Session ID and environment tags

🌐 API Monitoring with Dio #

final dio = Dio();

dio.interceptors.add(
  ApiInterceptor(LogServiceHive.to),
);

Logs:

• Request method & endpoint
• Request/response bodies (masked)
• Status & duration
• Slow API warnings
• API errors with stack traces

🖥 Open Log Viewer Screen #

Navigator.push(
        context,
        MaterialPageRoute(
        builder: (_) => LogViewerScreen(
                title: "App Logs",

                // Action buttons
                enableShareButton: true,
                enableRefreshButton: true,
                enableClearButton: true,

                // Search & filter
                enableCollapsibleSearch: true,
                showLevelChips: true,
                enablePullToRefresh: true,

                // Export system
                enableCustomExportMenu: true,
                allowedExportFormats: [
                LogExportFormat.txt,
                LogExportFormat.json,
                LogExportFormat.pdf,
                ],

                exportGroupByDate: true,
                exportFormat: LogExportFormat.pdf,
              ),
        ),
);

#Features:

• Filter by log level
• Expand stack traces
• Refresh logs
• Share logs
• Enterprise UI design

📊 Configuration Options #

LogConfig(
  retentionDays: 5,
  enableConsoleLog: true,
  sensitiveKeys: ["password", "secretKey"],
);

📁 Log Storage Location #

• Hive stores logs in your app's internal storage:

ApplicationDocumentsDirectory / hive / app_logs

🛡 Architecture Highlights #

• Automatic route tracking
• Automatic crash tagging
• Session & environment tagging (SessionManager + LogContext)
• Enterprise filtering engine
• No dependency injection required
• Works with GetX or without it
• Easily extendable to cloud upload
• Modular production-ready architecture
• Safe for release builds

📈 SEO Keywords #

Flutter logger
Flutter crash logger
Flutter file logger
Flutter API interceptor
Flutter production monitoring
Flutter enterprise logging
Flutter monitoring framework
Flutter error tracking
Flutter debugging tool
Flutter performance monitoring

🏆 Designed for Production #

flutter_log_handler flutter_log_handler provides structured, production-safe logging for enterprise-grade Flutter apps.

📄 License #

MIT License

👨‍💻 Maintainer #

ASTR Raju
Enterprise Flutter Developer

GitHub: https://github.com/ASTR001