inline_logger #

A powerful inline logger for Flutter that lets you log anywhere in your widget tree without breakpoints.

Maintained by Akshay Chand T (akshaychandt)

✨ Why inline_logger? #

Traditional logging requires you to break your code flow, add print statements, and often rebuild your UI. With inline_logger, you can log any value inline - directly in your widget tree, method chains, or anywhere else - without disrupting your code!

// ❌ Traditional way
final userName = user.name;
print('User name: $userName');
return Text(userName);

// ✅ With inline_logger
return Text(user.name.log('User name'));

🚀 Features #

🔗 Chainable inline logging - Log any value without breaking code flow
🎯 Multiple log levels - Debug, Verbose, Info, Success, Warning, Error, Critical
🎨 Color-coded output - Different colors for each log level in console
🎨 Emoji indicators - Visual log levels (can be disabled)
⚡ Zero performance impact - Automatically disabled in release mode
📊 Log history - Store important logs for crash reporting
🔍 Stack trace support - Capture stack traces for errors
🌳 Widget tree logging - Log anywhere in your build methods
⚙️ Highly configurable - Customize timestamps, emojis, colors, log levels

📦 Installation #

Add this to your pubspec.yaml:

dependencies:
  inline_logger: ^0.1.0

Then run:

flutter pub get

🎯 Quick Start #

Import the package #

import 'package:inline_logger/inline_logger.dart';

Basic Usage #

The most powerful feature - log directly in your widget tree:

@override
Widget build(BuildContext context) {
  return Column(
    children: [
      // Log user data inline without breaking the widget tree
      Text(userData.log('User data').name),

      // Log calculations inline
      Text('Total: ${(price * quantity).logInfo('Calculated total')}'),

      // Chain multiple logs
      Text(user.log('Full user').email.logDebug('Email address')),
    ],
  );
}

2. Method Chaining

// Chain logs on any expression
final result = apiCall()
  .log('API Response')
  .data
  .logSuccess('Data extracted')
  .firstWhere((item) => item.id == 5)
  .logDebug('Found item');

3. Direct Logging Methods

Logger.debug('Debugging info');
Logger.info('General information');
Logger.success('Operation completed successfully!');
Logger.warning('Warning message');
Logger.error('Error occurred', 'Context', stackTrace);
Logger.critical('Critical failure!');

📚 Log Levels #

inline_logger supports 7 log levels with color-coded output:

Level	Color	Emoji	Method	Use Case
Debug	Gray	🔍	`.logDebug()`	Debugging information
Verbose	Cyan	📝	`.logVerbose()`	Detailed logs
Info	Blue	ℹ️	`.logInfo()`	General information
Success	Green	✅	`.logSuccess()`	Successful operations
Warning	Yellow	⚠️	`.logWarning()`	Warnings
Error	Red	❌	`.logError()`	Errors
Critical	Bright Red	🚨	`.logCritical()`	Critical failures

🎨 Advanced Features #

Configuration #

// Set minimum log level (only warnings and above)
LoggerConfig.minLevel = LogLevel.warning;

// Disable timestamps
LoggerConfig.showTimestamp = false;

// Disable emojis
LoggerConfig.showEmoji = false;

// Enable/disable color-coded output
LoggerConfig.useColors = true; // Default is true

// Disable logging completely
LoggerConfig.enabled = false;

Color-Coded Console Output #

inline_logger automatically adds ANSI color codes to your console output, making it easy to distinguish between different log levels at a glance:

Debug logs appear in gray
Verbose logs appear in cyan
Info logs appear in blue
Success logs appear in green
Warning logs appear in yellow
Error logs appear in red
Critical logs appear in bright red

Colors work in most modern IDEs and terminals that support ANSI escape codes. You can disable colors if needed:

LoggerConfig.useColors = false;

API Logging #

// Log API requests
Logger.apiRequest(
  endpoint: '/api/users',
  method: 'POST',
  headers: {'Authorization': 'Bearer token'},
  body: {'name': 'John'},
);

// Log API responses with duration
Logger.apiResponse(
  endpoint: '/api/users',
  statusCode: 200,
  data: responseData,
  duration: Duration(milliseconds: 234),
);

Navigation Logging #

Logger.navigation('HomeView', 'ProfileView');

State Logging #

Logger.state('isLoading', true);
Logger.state('userData', userObject);

Lifecycle Logging #

Logger.lifecycle('initState', 'ViewModel initialized');
Logger.lifecycle('dispose', 'Cleaning up resources');

Log History #

// Access stored logs (warnings, errors, critical)
final history = LoggerConfig.logHistory;

// Clear history
LoggerConfig.clearHistory();

// Configure history size
LoggerConfig.maxHistorySize = 50;

Structured Logging #

Logger.header('USER AUTHENTICATION');
Logger.info('Starting process...');
Logger.success('Completed!');
Logger.divider();

💡 Real-World Examples #

ViewModel with inline logging #

class HomeViewModel extends ChangeNotifier {
  List<User> _users = [];

  Future<void> loadUsers() async {
    Logger.header('LOAD USERS');

    _isLoading = true.logState('isLoading');
    notifyListeners();

    try {
      final stopwatch = Stopwatch()..start();

      Logger.apiRequest(endpoint: '/api/users', method: 'GET');

      final response = await _api.getUsers();

      stopwatch.stop();
      Logger.apiResponse(
        endpoint: '/api/users',
        statusCode: 200,
        data: response,
        duration: stopwatch.elapsed,
      );

      _users = response.logSuccess('Users loaded');

    } catch (e, stackTrace) {
      Logger.error('Failed to load users: $e', 'Error', stackTrace);
    } finally {
      _isLoading = false.logState('isLoading');
      notifyListeners();
      Logger.divider();
    }
  }
}

Widget with inline logging #

@override
Widget build(BuildContext context) {
  return ListView.builder(
    itemCount: items.length.log('Item count'),
    itemBuilder: (context, index) {
      final item = items[index].logDebug('Current item');

      return ListTile(
        title: Text(item.name.log('Item name')),
        subtitle: Text(item.price.toString().logInfo('Price')),
        onTap: () => Navigator.push(
          context,
          MaterialPageRoute(
            builder: (_) => DetailView(
              id: item.id.log('Selected item ID'),
            ),
          ),
        ).then((_) => Logger.navigation('DetailView', 'HomeView')),
      );
    },
  );
}

🔧 Configuration Guide #

Production Setup #

void main() {
  // Disable in production
  if (kReleaseMode) {
    LoggerConfig.enabled = false;
  }

  // Or set minimum level to only show errors
  LoggerConfig.minLevel = LogLevel.error;

  runApp(MyApp());
}

Development Setup #

void main() {
  // Show everything in debug
  LoggerConfig.minLevel = LogLevel.debug;
  LoggerConfig.showTimestamp = true;
  LoggerConfig.showEmoji = true;
  LoggerConfig.useColors = true; // Enable color-coded output
  LoggerConfig.maxHistorySize = 100;

  runApp(MyApp());
}

📖 API Reference #

Extension Methods (Chainable) #

All these methods can be chained on any object:

.log([String key, LogLevel level]) - Log with custom level
.logDebug([String key]) - Log as debug
.logVerbose([String key]) - Log as verbose
.logInfo([String key]) - Log as info
.logSuccess([String key]) - Log as success
.logWarning([String key]) - Log as warning
.logError([String key]) - Log as error
.logCritical([String key]) - Log as critical

Static Methods #

Logger.debug(value, [name]) - Log debug
Logger.verbose(value, [name]) - Log verbose
Logger.info(value, [name]) - Log info
Logger.success(value, [name]) - Log success
Logger.warning(value, [name]) - Log warning
Logger.error(value, [name, stackTrace]) - Log error
Logger.critical(value, [name, stackTrace]) - Log critical
Logger.apiRequest({...}) - Log API request
Logger.apiResponse({...}) - Log API response
Logger.navigation(from, to) - Log navigation
Logger.state(name, value) - Log state change
Logger.lifecycle(event, [details]) - Log lifecycle event
Logger.divider([title]) - Log divider
Logger.header(title) - Log header

🤝 Contributing #

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License #

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Credits #

Created with ❤️ for the Flutter community.

Special thanks to aswinbbc for contributing ideas to this project.

inline_logger 0.1.0+2 inline_logger: ^0.1.0+2 copied to clipboard

Metadata