🚀 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!