📦 Zeba Academy Error Explorer Offline Flutter Error Intelligence Toolkit 🧭 Overview

Zeba Academy Error Explorer is a lightweight, offline-first Flutter package designed to help developers understand, search, categorize, and resolve common Flutter errors with structured explanations, stack trace parsing, and built-in solutions.

It acts as a local error knowledge base + debugging assistant UI toolkit.

🚀 Features 📚 Error Intelligence System Preloaded offline error database Categorized error system (State, UI, Network, Firebase, etc.) Structured error descriptions 🔍 Smart Search Engine Search errors by title or category Fast local filtering (no API dependency) 🧵 Stack Trace Analyzer Clean stack trace formatting Line-by-line breakdown view 💡 Solution Engine Built-in fix suggestions for each error Developer-friendly actionable steps 🔖 Bookmark System Save important errors Quick access to frequently seen issues 🧱 Architecture

The package follows a clean MV (Model–View) architecture:

lib/ │ ├── models/ # Data structures (AppError, Category) ├── database/ # Offline error dataset ├── repository/ # Data access layer ├── controller/ # Business logic layer ├── ui/ # Screens & widgets └── utils/ # Stack trace parser 📊 Core Model AppError Structure AppError( id: "1", title: "Null check operator used on a null value", description: "Occurs when '!' is used on null", category: "Null Safety", stackTrace: "...", solutions: "Check null before using !", "Use null-aware operators (??)", , ) ⚙️ Installation

Add dependency:

dependencies: zeba_academy_error_explorer: ^1.0.0

Then install:

flutter pub get 📥 Import Package import 'package:zeba_academy_error_explorer/zeba_academy_error_explorer.dart'; 🧠 Usage Guide 1️⃣ Initialize Controller final controller = ErrorController(); controller.loadErrors(); 2️⃣ Search Errors controller.search("null safety"); 3️⃣ Filter by Category controller.filter("State Management"); 4️⃣ Bookmark Error controller.toggleBookmark(error); 5️⃣ Open UI Screen Navigator.push( context, MaterialPageRoute( builder: (_) => const ErrorExplorerScreen(), ), ); 🖥️ UI Screens 📌 Error Explorer Screen Displays full error list Search bar support Bookmark toggle 📄 Error Detail Screen Full error description Stack trace viewer Step-by-step solutions 🔖 Bookmark Screen Saved errors list Quick revisit system 🔎 Error Categories Null Safety State Management Firebase UI Rendering Network Platform Dart Core Performance 🧪 Testing

Run tests:

flutter test 📊 Code Analysis flutter analyze 🛣️ Roadmap Riverpod integration Persistent storage (Hive support) Custom JSON error import Global Flutter error interceptor AI-powered fix suggestions engine VS Code extension companion 👨‍💻 Author ✨ Sufyan bin Uzayr

Open-source developer focused on building meaningful developer tools.

🌐 Website: https://sufyanism.com 💼 LinkedIn: https://www.linkedin.com/in/sufyanism

🌐 Zeba Academy Ecosystem

Your all-in-one learning hub for coding & development.

🌍 https://zeba.academy 💻 https://code.zeba.academy 📺 https://www.youtube.com/@zeba.academy 📸 https://www.instagram.com/zeba.academy/ 📜 License

This project is licensed under:

GNU GENERAL PUBLIC LICENSE v3.0 (GPL-3.0)

You are free to:

Use Modify Distribute

But must:

Keep source open Retain license Share modifications under GPL

Full license: https://www.gnu.org/licenses/gpl-3.0.html

⭐ Support

If you like this project:

⭐ Star the repository 🔁 Share with developers 🧑‍💻 Contribute improvements