README

Flowstone is a powerful Laravel package that integrates the robust Symfony Workflow engine into your Laravel applications. Build sophisticated workflow and state machine systems with database-driven configurations, role-based permissions, and seamless Laravel integration.

🚀 Key Features

• 🔄 Database-Driven Workflows - Configure workflows through the database for runtime flexibility
• 🏛️ Symfony Workflow Integration - Built on the proven Symfony Workflow component
• 👥 Role-Based Permissions - Control who can perform transitions with metadata-driven roles
• 📊 Predefined Status Enum - Ready-to-use workflow states (Draft, Pending, Approved, etc.)
• ⚡ Performance Optimized - Workflow configuration caching and efficient queries
• 🎯 Multiple Workflow Types - Support for both State Machines and Workflows

Table of Contents

• Installation
• Documentation
• Examples
• Testing
• Contributing
• License

Installation

Install Flowstone via Composer:

composer require cleaniquecoders/flowstone

Publish and run the migrations:

php artisan vendor:publish --tag="flowstone-migrations"
php artisan migrate

Optionally, publish the configuration file:

php artisan vendor:publish --tag="flowstone-config"

Documentation

Comprehensive documentation is available in the docs/ directory:

• Getting Started - Installation and quick start guide
• Configuration - Configure workflows, UI, and performance
• Usage Guide - Workflows, details, and visual designer
• API Reference - Complete API documentation

Examples

Real-world examples are available in the examples/ directory:

• Bug Tracking - Issue lifecycle management
• Content Publishing - Content approval workflow
• Document Approval - Multi-step approval process
• E-commerce Order - Order fulfillment workflow
• Employee Onboarding - New hire process

Testing

composer test

Contributing

Please see CONTRIBUTING for details.

License

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