🔥 FlareLog CLI v1.0.0

FlareLog is a professional, production-grade logging dashboard for Flutter developers. It streams your flutter run logs into a beautiful, multi-pane terminal interface, automatically separating them into specifically categorized streams.

🚀 Key Features

• ⚡ Real-Time Multiplexing: Powered by tmux to provide a unified dashboard without window clutter.
• 📂 Automatic Log Separation: Intelligently routes logs into 4 distinct files and panes:
  • 🔴 ERROR: Exceptions, crashes, and stack traces.
  • 🟠 WARNING: Deprecation notices and slow widget warnings.
  • 🟢 APP: Your custom print() and debugPrint() statements.
  • 🔵 SYSTEM: Gradle builds, hot reload status, and device info.
• 🧹 Auto-Clean Architecture: Automatically empties previous log files on every new run.
• 🛠️ Scaling Layouts: Dynamically switches between 4 and 8-pane layouts based on your usage.
• 🌈 Native Look & Feel: Supports a "Single Terminal" mode (flog run) for a color-coded, labeled stream identical to standard flutter run.

📦 Installation

1. Prerequisites

Ensure you have tmux installed on your system:

• macOS: brew install tmux
• Linux: sudo apt install tmux

2. Install FlareLog

Install globally via NPM:

npm install -g flarelog

🎮 How to Use

Simply navigate to your Flutter project directory and run:

flog

This will launch the Interactive Menu where you can choose your logging mode using the arrow keys!

Available Commands:

| Command | Description | | :--- | :--- | | flog start | Launches the multi-pane tmux Dashboard. | | flog run | Streams all categorized logs in your current terminal (Single Stream). | | flog status | Checks if a logging session is currently active. | | flog stop | Safely terminates all active loggers and tmux sessions. | | flog reset | Resets the layout state back to the 4-pane start. |

🔍 How it Works

FlareLog uses a Stateful Priority Engine to classify every single line of Flutter output:

1. Block Tracking: If an Error/Exception is detected, all following stack trace lines are "sticky" and will stay in the Error stream.
2. I/flutter Logic: Specialized rules identify if your app prints contain hidden errors or warnings.
3. Fallback: Any unrecognized log is safely funneled into the System stream so you never miss a hidden detail.

📁 Log Storage

All logs are stored in a project-local folder: ./logs/app.log ./logs/error.log ./logs/warning.log ./logs/system.log

📜 License

MIT License. Created by FlareLog Team.