🎉 Laravel Flowpipe v1.0 is out! 🎉

[Grazulex]

🎉 Laravel Flowpipe v1.0 is out! 🎉
A powerful, modern alternative to Laravel's Pipeline

---

We're thrilled to announce the v1.0 release of Laravel Flowpipe — a composable, traceable, and declarative pipeline engine for Laravel 12+, built to handle everything from simple data processing to complex error-handled workflows.

🧩 What is Flowpipe?

Laravel Flowpipe lets you define modular, testable, traceable flows using a fluent API, conditional logic, nested pipelines, YAML definitions, and powerful error handling strategies (retry, fallback, compensation, etc.).

It’s inspired by Laravel's Pipeline, but goes way further.

---

✨ Highlights

• Fluent API: Flowpipe::make()->send()->through()->thenReturn()
• Closures & Step Classes
• Conditional logic: when(), unless() with dot notation or class-based conditions
• Reusable groups of steps
• Nested flows
• Tracing & debugging
• Advanced error handling: Retry, Fallback, Compensation, Composite strategies
• YAML flow definitions
• Artisan commands for listing, validating, exporting, and running flows
• TestTracer for test assertions
• Mermaid export with group coloring

---

🚀 Installation

composer require grazulex/laravel-flowpipe

---

📌 Requirements

• PHP 8.3+
• Laravel 12+

---

🧪 Quick Example

use Grazulex\LaravelFlowpipe\Flowpipe;

$result = Flowpipe::make()
    ->send('Hello World')
    ->through([
        fn($d, $n) => $n(strtoupper($d)),
        fn($d, $n) => $n(str_replace(' ', '-', $d)),
        fn($d, $n) => $n($d . '!'),
    ])
    ->thenReturn();

// Result: "HELLO-WORLD!"

---

🛡 Error Handling Example

use Grazulex\LaravelFlowpipe\Flowpipe;

$result = Flowpipe::make()
    ->send(['user_id' => 123])
    ->withFallback(fn($payload, $e) => ['cached' => true, 'user_id' => $payload['user_id']])
    ->through([
        fn($data, $next) => $next(fetchUser($data['user_id'])),
    ])
    ->thenReturn();

---

🧠 YAML Flow Definitions

You can define entire flows in .yaml files:

flow: UserProcessingFlow
steps:
  - type: group
    name: user-validation
  - type: nested
    steps:
      - type: closure
        action: uppercase

...and run them via Artisan:

php artisan flowpipe:run user_processing

---

🛠 Artisan Power

php artisan flowpipe:list
php artisan flowpipe:run example
php artisan flowpipe:validate --all
php artisan flowpipe:export my_flow --format=mermaid

---

📖 Docs & Examples

✅ Full Docs: https://github.com/Grazulex/laravel-flowpipe#readme
✅ Artisan Commands
✅ Error Handling
✅ Examples

---

❤️ Credits

Created and maintained by Jean‑Marc Strauven
Contributions welcome!

---

📬 Get Involved

• 🐛 Report Issues
• 💬 Start Discussions
• 📚 Read Docs

---

Let us know how you're using Flowpipe in your projects.
We’d love your feedback and ideas for v1.1+ 🚀