logscope_flutter library

Debug logging toolkit with automatic issue-layer classification.

• DebugLogStore — singleton ring buffer with broadcast stream and export.
• AppLogger — static methods that print via debugPrint in debug mode.
• DebugLogInterceptor — Dio interceptor with sanitized HTTP logging.
• LogsFab — draggable debug FAB + fullscreen log console overlay with Device & App Info tab (auto-detected platform, session stats).
• LayerClassifier — auto-classifies logs as SERVER/NETWORK/MOBILE/AUTH.

Classes

AppLogger

Centralized logging utility for structured in-app logging.

DebugLogInterceptor

A Dio Interceptor that captures all HTTP requests, responses, and errors into DebugLogStore for the debug console.

DebugLogStore

Singleton store for debug log entries.

DeviceContext

Device and app context attached to exported log reports.

LayerClassifier

Classifies LogEntry instances into an IssueLayer.

LogEntry

A single log entry captured from AppLogger or DebugLogInterceptor.

LogRingBuffer<T>

Fixed-size circular buffer with O(1) add.

Logscope

One-stop entry point for the debug console.

LogsFab

A draggable floating debug FAB widget.

Enums

IssueLayer

The layer where an issue likely originates.

LogLevel

Log severity levels for the debug console.

Extensions

IssueLayerDisplay on IssueLayer

Extension for UI display properties.

Typedefs

LayerRule = IssueLayer? Function({required String levelName, required String message, Map<String, dynamic>? metadata, String? tag})

A single classification rule tested against a log entry's properties.