emitrace 1.0.0

One tap bug reports for Flutter QA teams. Never reproduce a QA bug manually again.

Emitrace

One-tap Flutter debugging for QA and developers.
Capture logs, network calls, runtime errors, screenshots, and export clean reports from inside your app.

Why Emitrace

• Fast in-app debugging without leaving the device.
• Better bug reports with event timeline + metadata.
• Team-ready summaries via Slack webhook.

Features

• Floating E launcher overlay.
• Logs with filters: all, network, error, navigation, log.
• Tap any log to inspect full metadata/body.
• Dio network tracing using EmitraceDioInterceptor.
• Auto screenshot capture on framework/platform errors.
• Optional save screenshot to gallery.
• Markdown report generation.
• Share/export report from device.
• Send report summary to Slack webhook.

Installation

dependencies:
  emitrace: ^1.0.0

Quick Start

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

final GlobalKey<NavigatorState> appNavigatorKey = GlobalKey<NavigatorState>();

void main() {
  runApp(
    EmitraceScope(
      config: EmitraceConfig(
        appName: 'My App',
        navigatorKey: appNavigatorKey,
        showOverlay: true,
        enableAutoScreenshotOnError: true,
        enableReportGenerator: true,
        enableSlackIntegration: false,
      ),
      child: MaterialApp(
        navigatorKey: appNavigatorKey,
        home: const HomePage(),
      ),
    ),
  );
}

Network Tracking (Dio)

final dio = Dio();
dio.interceptors.add(EmitraceDioInterceptor());

Configuration

Option	Type	Default	Description
enabled	bool	true	Enable/disable Emitrace.
appName	String	"My App"	App label in reports/messages.
showOverlay	bool	true	Show floating E launcher.
navigatorKey	GlobalKey<NavigatorState>?	null	Required for reliable panel presentation.
maxBreadCrumbs	int	50	Max stored events (rolling buffer).
slackWebHookUrl	String?	null	Incoming webhook URL for Slack summary posting.
enableAutoScreenshotOnError	bool	true	Capture screenshot on runtime errors.
enableReportGenerator	bool	true	Enable report generation.
enableSlackIntegration	bool	false	Enable Slack send action.
screenshotPixelRatio	int	2	Screenshot resolution scale.
autoSaveScreenshotToGallery	bool	false	Attempt save captured screenshot to gallery.

Platform Notes

• iOS: add photo library usage keys if gallery save is enabled.
• Slack webhook can post summary text; local file paths are not shareable outside device.
• Slack file upload via bot token/API is planned for a future version.
• Some iOS/macOS dependencies currently resolve through CocoaPods because upstream plugins may not fully support Swift Package Manager yet.

QA Flow

1. Reproduce issue.
2. Open E panel.
3. Inspect logs/network/errors.
4. Tap error log for metadata + screenshot.
5. Generate and share report.
6. Send summary to Slack.

Roadmap

• Slack file upload (actual report attachment).
• Hosted report URLs.
• Rich HTML report export.

License

MIT License. See LICENSE.