🚀 zeba_academy_auto_flow #

Reusable workflow automation engine for Flutter — build powerful trigger-based pipelines, automate logic flows, and debug execution visually.

✨ Features #

✅ Define reusable workflows ✅ Trigger-based execution system ✅ Automation pipelines with sequential steps ✅ Lightweight and scalable architecture ✅ Debug logging system ✅ Visual flow debugging support

📦 Installation #

Add this to your pubspec.yaml:

dependencies:
  zeba_academy_auto_flow: ^0.0.1

🚀 Getting Started #

import 'package:zeba_academy_auto_flow/zeba_academy_auto_flow.dart';

void main() async {
  final context = FlowContext();
  final engine = FlowEngine();

  final pipeline = FlowPipeline();

  pipeline.addNode(
    FlowNode(
      id: "step1",
      action: (ctx) async {
        print("Step 1 executed");
        ctx.set("value", 10);
      },
    ),
  );

  pipeline.addNode(
    FlowNode(
      id: "step2",
      action: (ctx) async {
        print("Step 2 executed with ${ctx.get("value")}");
      },
    ),
  );

  final trigger = FlowTrigger(
    name: "start_trigger",
    condition: (ctx) => true,
    pipeline: pipeline,
  );

  engine.registerTrigger(trigger);

  await engine.run(context);
}

🧠 Core Concepts #

🔹 FlowContext #

Stores shared state across the workflow.

🔹 FlowNode #

Represents a single executable step.

🔹 FlowPipeline #

Chains multiple nodes into a reusable workflow.

🔹 FlowTrigger #

Executes pipelines based on conditions.

🔹 FlowEngine #

Manages and runs all triggers.

🔹 FlowDebugger #

Tracks logs for debugging and visualization.

🧪 Testing #

Run tests using:

flutter test

📊 Use Cases #

• 🔄 Automation pipelines
• ⚙️ Background workflow execution
• 📊 Event-driven systems
• 🧩 Modular business logic orchestration
• 🧠 Low-code / no-code builders

🔥 Roadmap #

• ❌ Conditional branching (if/else)
• ❌ Parallel execution
• ❌ Retry & error handling
• ❌ JSON workflow builder
• ❌ Drag & drop visual flow editor
• ❌ Remote config support

🤝 Contributing #

Contributions are welcome! Feel free to open issues and submit pull requests.

📄 License #

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).

👨‍💻 About Me #

✨ I’m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects. You can learn more about me and my work at sufyanism.com or connect with me on Linkedin

🌐 Your all-in-one no-bloat hub! #

🚀 Explore cutting-edge resources in coding, tech, and development at zeba.academy and code.zeba.academy. Empower yourself with practical skills through curated directives, real-world projects, and hands-on experience. Level up your tech game today! 💻✨

Zeba Academy is a learning platform dedicated to coding, technology, and development.

➡ Visit our main site: https://zeba.academy ➡ Explore hands-on courses: https://code.zeba.academy ➡ YouTube: https://www.youtube.com/@zeba.academy ➡ Instagram: https://www.instagram.com/zeba.academy/

❤️ Support #

If you like this project, consider giving it a ⭐ on GitHub!

Thank you for visiting!