PuppetLogger #

A colorful, flexible logger for Flutter & Dart with optional symbols.

Built for my own use case — sharing it so you can enjoy it too.

Features #

• Colorful logs in terminal (foreground & background)
• Optional symbols [i], [S], [!], [X] or full text [INFO], [SUCCESS]
• Per-log overrides for background, symbols
• Clean, readable timestamps
• Works in Flutter & pure Dart projects
• Debug-only logging (won’t spam release builds)

Getting Started #

Add puppetlogger to your pubspec.yaml:

dependencies:
  puppetlogger: ^1.0.0

Import it:

import 'package:puppetlogger/puppetlogger.dart';

Basic Usage #

Just use it. Nothing fancy required.

Log.info("Sir, you got some information here.");
Log.success("Yo Success.");
Log.warning("Warning — read it or don’t, who cares.");
Log.error("Damn, an error again.");

This gives you clean, colored logs in the terminal.

Enable Background Colors (Global) #

If you want background colors everywhere, enable it once (usually in main()):

void main() {
  LogConfig.useBackground;

  Log.info("Sir, you got some information here.");
  Log.success("Yo Success.");
  Log.warning("Warning incoming.");
  Log.error("Damn, an error again.");
}

Enable Symbols (Global) #

Want symbols instead of full text?

void main() {
  LogConfig.useSymbols;

  Log.info("Sir, you got some information here.");
  Log.success("Yo Success.");
  Log.warning("Warning incoming.");
  Log.error("Damn, an error again.");
}

Per-Log Overrides (This Is the Fun Part) #

Sometimes you want one log to behave differently.

You can override global settings per log call:

void main() {
  LogConfig.useBackground;
  LogConfig.useSymbols;

  Log.info("Normal log");
  Log.success("No background here", useBackground: false);
  Log.warning("Still using global config");
  Log.error(
    "Custom override",
    useBackground: false,
    useSymbols: true,
  );
}

This helps keep important logs obvious without making everything loud.

Why PuppetLogger? #

I wanted:

• Logs that are easy to scan
• Visual separation without overthinking it
• Zero setup
• Control when I need it

So I built this.

If it helps you too — awesome.

What’s Next #

Planned ideas (no promises, just vibes):

• Custom time formatting
• Message templates
• Optional log files
• Backend / feedback export

License #

MIT License © 2026 PuppetDigital