workflowable/workflowable

A flexible, event-driven workflow engine for Laravel with conditional branching, retry policies, and full audit trails.

0.2.0 2026-03-16 20:26 UTC

Requires

• php: ^8.3
• dragonmantank/cron-expression: ^3.4
• illuminate/contracts: ^11.0||^12.0
• spatie/laravel-event-sourcing: ^7.15
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.14
• nunomaduro/collision: ^8.8
• orchestra/testbench: ^10.0.0||^9.0.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0

MIT

• Andrew Leach

• laravel
• Workflowable

README

A flexible, event-driven workflow engine for Laravel. Build complex business processes with conditional branching, retry policies, and complete audit trails.

Features

• Data-driven workflow definitions stored as JSON
• Action and Conditional step types, plus custom step type registration
• Registry-based conditional branching
• Per-step retry policies with fixed, linear, or exponential backoff
• Event-driven triggers via Laravel events
• CRON-based scheduled workflow triggers
• Queued async execution
• Workflow versioning with instance pinning
• Full audit trail via Spatie event sourcing
• Artisan commands for managing workflows
• Testing utilities with TestsWorkflows trait

Installation

composer require workflowable/workflowable
php artisan vendor:publish --tag="workflowable-migrations"
php artisan migrate
php artisan vendor:publish --tag="workflowable-config"

Documentation

Visit the Workflowable Documentation for full guides on getting started, architecture, step types, triggers, and more.

Testing

docker compose up -d
composer test

Changelog

See CHANGELOG.md for all versions.

Contributing

Please see CONTRIBUTING.md for details.

License

The MIT License (MIT). Please see License File for more information.