ConsolePlus

A floating in-app console for Flutter — view, filter, search & export logs while your app runs! console_plus provides a non-intrusive floating console for Flutter apps, designed to debug logs directly on-device.

It helps developers:

View runtime logs above the app UI
Debug production issues without connecting to IDE
Filter and export logs instantly
Use it in QA or beta builds for field debugging

Features

✅ Floating draggable console overlay
✅ Logs display above your app’s UI (non-blocking)
✅ Supports multi-line text selection
✅ Auto-scroll when near the bottom
✅ Filter logs by type (INFO, WARNING, ERROR)
✅ Keyword search for tags or text
✅ Horizontal scrolling for long lines
✅ Copy, clear, and export logs as JSON
✅ Built-in floating bug icon to toggle visibility

Installation

Add to your project's pubspec.yaml:

dependencies:
  console_plus: ^1.0.0

Then fetch packages:

flutter pub get

Import it:

import 'package:console_plus/console_plus.dart';

💻 Usage

Step 1 — Show Floating Debug Button

FloatingDebugButton.show(context);

This shows a draggable 🐞 button that opens the console overlay.

Step 2 — Log Messages

Use:

DebugLogConsole.log("User logged in successfully");
DebugLogConsole.log("Missing field: email", type: LogType.warning);
DebugLogConsole.log("API request failed", type: LogType.error);

Or replace all print() calls in your app with:

DebugLogConsole.customLog("Something happened");

Step 3 — Export Logs

Tap the ⬇️ Download icon in the console header to export as a .json file. You can also programmatically call:

final json = await DebugLogConsole.exportLogs(asJson: true);

🎛️ Console UI

Draggable & resizable window
Search bar to filter logs
Dropdown filter for log levels
Copy, export, and clear actions
Persistent scroll and multi-line selection

🧩 Example

void main() {
  runApp(const MyApp());
  WidgetsBinding.instance.addPostFrameCallback((_) {
    FloatingDebugButton.show(context);
    DebugLogConsole.log("App started");
  });
}

📂 File Export

Format: .json

Example output:

[
  {
    "timestamp": "2025-11-08T12:30:01.345Z",
    "type": "info",
    "message": "App started"
  },
  {
    "timestamp": "2025-11-08T12:31:14.123Z",
    "type": "error",
    "message": "Network timeout"
  }
]

Contributing

PRs welcome. Keep debug-only behaviour intact. If you add native platform code, ensure release builds keep plugin inert unless explicitly enabled.

Floating Button	Console Overlay	Search Filter

📜 License

💬 Credits

Built with ❤️ by Ashish Follow for updates and Flutter dev tips!