app_logs 0.1.0

Production-safe logging for Flutter with tags, levels, redaction

app_logs

A simple, production-safe logging library for Flutter.

Use it to print clean logs during development, and keep logging controlled and safer in release builds.

---

Features

• Log levels: debug, info, warn, error, fatal
• Tags: group logs like API, AUTH, DB, UI
• Structured data: attach extra info with data: {}
• Sanitization: (enabled in default configs) redacts emails/phones in messages
• Truncation: limits very large logs (example: huge JSON)
• Error + stack trace: log failures with full context
• Optional global error hooks: capture uncaught Flutter/platform errors

---

Installation

pub.dev

dependencies:
  app_logs: ^0.1.0

flutter pub get

GitHub

dependencies:
  app_logs:
    git:
      url: https://github.com/ahmedchoteri/app_logs.git
      ref: main

flutter pub get

---

Quick start

Initialize once in main.dart:

import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'package:app_logs/app_logs.dart';

void main() {
  // Debug: more logs. Release: only warnings + errors.
  Log.init(kReleaseMode ? LogConfig.releaseSafe() : LogConfig.debug());

  // Optional: capture uncaught errors
  FlutterLogHooks.installGlobalHandlers();

  runApp(const MyApp());
}

---

Usage

Basic logs

Log.d('Dashboard opened');
Log.i('User logged in');
Log.w('API is slow', data: {'ms': 920});
Log.e('Failed to load profile', error: e, st: st);
Log.f('Unexpected crash', error: e, st: st);

Tagged logs (recommended)

final api = Log.tag('API');

api.d('GET /users started');
api.i('GET /users success', data: {'status': 200});
api.e('GET /users failed', error: e, st: st);

---

Release safety (important)

Recommended setup:

Log.init(kReleaseMode ? LogConfig.releaseSafe() : LogConfig.debug());

• LogConfig.debug() → more logs for development
• LogConfig.releaseSafe() → only important logs (warn/error) for production

---

Sanitization (privacy)

Default configs include sanitization. If a message contains an email or phone number, it is redacted:

Log.i('Contact: [e-mail], [phone]', tag: 'SAFE');

Printed output will hide that data:

• Contact: [REDACTED_EMAIL], [REDACTED_PHONE]

Note: Avoid logging passwords, tokens, OTPs, or secrets.

---

Global error capturing (optional)

Enable:

FlutterLogHooks.installGlobalHandlers();

This logs:

• Flutter framework errors
• Uncaught platform errors

Optional zone wrapper:

FlutterLogHooks.runZonedGuarded(() {
  runApp(const MyApp());
});

---

License

MIT (see LICENSE).