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