LiteLogger #

A fast, lightweight, and customizable logging utility for Dart & Flutter — with colored output, emoji icons, log filtering, and powerful formatting.

Features #

• Log Level Filtering: Control output visibility (error, warning, success, info, step, debug)
• Colorized Output: ANSI terminal colors for instant visual clarity
• Emoji Indicators: Makes reading console logs effortless
• Lazy Message Evaluation: Prevents unnecessary computation
• Custom Formatting: Fully configurable message templates
• Callback Support: Redirect logs to file, cloud, or analytics
• Global Enable/Disable Switch

Getting Started #

final logger = LiteLogger(
    name: 'MyApp',          // Optional: identify the logger in output
    enabled: true,
    minLevel: LogLevel.debug, // show all levels
);

logger.info('Application started');
logger.step('Loading configuration...');
logger.debug(() => 'Debug timestamp: ${DateTime.now().millisecondsSinceEpoch}');
logger.success('Configuration loaded');
logger.warning('Low disk space');
logger.error('Unable to access database');

Advanced Configuration #

final logger = LiteLogger(
  name: 'MyService',        // Logger name for identification
  enabled: true,
  minLevel: LogLevel.debug,
  timestamp: (dt) => '[${dt.toIso8601String()}]',
  format: '@{color}@{timestamp} @{icon} [@{level}] @{message}',
  usePrint: false,         // Use developer.log() (default) or print()
  callback: (raw, colored, level) {
    // Save logs to file or send to a remote endpoint
  },
);

<｜tool▁calls▁begin｜><｜tool▁call▁begin｜> read_file

Supported Format Tokens #

Log Filtering Example #

const logger = LiteLogger(minLevel: LogLevel.warning);

logger.log('This is info', LogLevel.info);     // ❌ Not logged
logger.log('This is warning', LogLevel.warning); // ✅ Logged
logger.log('This is error', LogLevel.error);     // ✅ Logged

Using Callback for Custom Output #

const logger = LiteLogger(
  callback: (raw, colored, level) {
    sendToServer({'level': level.text, 'message': raw});
  },
);

Logger Naming #

Use the name parameter to identify different loggers in your application. This is especially useful when you have multiple loggers for different components.

final apiLogger = LiteLogger(name: 'API');
final dbLogger = LiteLogger(name: 'Database');
final authLogger = LiteLogger(name: 'Auth');

apiLogger.info('Fetching user data');
dbLogger.debug('Executing query...');
authLogger.warning('Token expiring soon');

Output with names:

[API] [12:34:56] 💡 [INFO] Fetching user data
[Database] [12:34:56] 🧠 [DBUG] Executing query...
[Auth] [12:34:57] ⚠️ [WARN] Token expiring soon

Output Methods #

LiteLogger supports two output methods controlled by the usePrint parameter:

• usePrint: false (default): Uses developer.log() from dart:developer

  • Cleaner output with less platform noise
  • Better integration with development tools
  • Supports structured logging metadata

• usePrint: true: Uses print() for maximum compatibility

  • Works everywhere (console, Flutter, web)
  • May include platform-specific prefixes (e.g., I/flutter in Flutter)

// Using developer.log() (default)
final logger1 = LiteLogger(name: 'App', usePrint: false);

// Using print()
final logger2 = LiteLogger(name: 'App', usePrint: true);

License #

Licensed under the MIT License — free for personal and commercial use.

Contributing #

Contributions, bug reports, and ideas are always welcome!