PHPackages                             cleaniquecoders/flowstone - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. cleaniquecoders/flowstone

ActiveLibrary[Framework](/categories/framework)

cleaniquecoders/flowstone
=========================

Flowstone - Laravel Workflow Engine with Symfony Workflow Integration

1.4.0(3mo ago)4838↓66.7%2[1 PRs](https://github.com/cleaniquecoders/flowstone/pulls)1MITPHPPHP ^8.2CI passing

Since Oct 23Pushed 2mo agoCompare

[ Source](https://github.com/cleaniquecoders/flowstone)[ Packagist](https://packagist.org/packages/cleaniquecoders/flowstone)[ Docs](https://github.com/cleaniquecoders/flowstone)[ GitHub Sponsors]()[ RSS](/packages/cleaniquecoders-flowstone/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (7)Dependencies (16)Versions (9)Used By (1)

Flowstone
=========

[](#flowstone)

[![Latest Version on Packagist](https://camo.githubusercontent.com/7acaa5a018ee40ac245fdf0bae03f6473bcbafae38623cb0e9a753a2a7964f14/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636c65616e69717565636f646572732f666c6f7773746f6e652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/cleaniquecoders/flowstone) [![GitHub Tests Action Status](https://camo.githubusercontent.com/dc4dd35ee58194dd948c5263b53d532619eec7d6950636a4bb4c633bf9bcfa0b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f636c65616e69717565636f646572732f666c6f7773746f6e652f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/cleaniquecoders/flowstone/actions?query=workflow%3Arun-tests+branch%3Amain) [![GitHub Code Style Action Status](https://camo.githubusercontent.com/47d38e893c93de266bb1bfa0b5b6f1db67b8e9637ad613e4961b47ba0910acdc/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f636c65616e69717565636f646572732f666c6f7773746f6e652f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/cleaniquecoders/flowstone/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain) [![Total Downloads](https://camo.githubusercontent.com/ad540e8fa787f21638b285b9fb5590a2565e7689fb7490b42983954c8aa37504/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636c65616e69717565636f646572732f666c6f7773746f6e652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/cleaniquecoders/flowstone)

**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.

[![Workflow Designer — Document Approval](screenshots/workflow-designer-document-approval.png)](screenshots/workflow-designer-document-approval.png)

🚀 Key Features
--------------

[](#-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

💡 Why Flowstone?
----------------

[](#-why-flowstone)

### Laravel-Native Workflow Integration

[](#laravel-native-workflow-integration)

Unlike Symfony's configuration-based approach, Flowstone uses **Laravel traits** for better developer experience:

```
// ✅ Flowstone way - Full IDE support!
class Document extends Model implements WorkflowContract
{
    use InteractsWithWorkflow;  // Get 50+ workflow methods instantly

    // IDE autocomplete ✅ | Type hints ✅ | Dynamic workflows ✅
}

// ❌ Symfony way - Config-based, no IDE support
'supports' => [App\Models\Document::class],  // Hard-coded in config
```

**Benefits:**

- ✅ **Full IDE Autocomplete** - IntelliSense for all workflow methods
- ✅ **Type Safety** - Compile-time type checking
- ✅ **Dynamic Workflows** - Choose workflows at runtime
- ✅ **Self-Documenting** - Just look at the model to see workflow support
- ✅ **Better Testing** - Mock workflow behavior directly

See [detailed comparison in docs](docs/02-configuration/01-configuration.md#model-integration-trait-vs-supports-configuration).

Table of Contents
-----------------

[](#table-of-contents)

- [Requirements](#requirements)
- [Installation](#installation)
- [Documentation](#documentation)
- [Examples](#examples)
- [Testing](#testing)
- [Contributing](#contributing)
- [License](#license)

Requirements
------------

[](#requirements)

- **PHP**: 8.2, 8.3, or 8.4
- **Laravel**: 10.x, 11.x, or 12.x
- **Database**: MySQL, PostgreSQL, SQLite, or SQL Server

### Version Compatibility

[](#version-compatibility)

FlowstonePHPLaravelSymfony WorkflowLivewire1.3.1+8.2-8.410.x-12.x6.4-7.x3.0+1.3.08.411.x-12.x7.3+3.6+> **Note:** Laravel 9 is not supported due to dependency requirements. Laravel 9 reached end-of-life in February 2024.

Installation
------------

[](#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
-------------

[](#documentation)

Comprehensive documentation is available in the [`docs/`](docs/) directory:

- **[Getting Started](docs/01-getting-started/)** - Installation and quick start guide
- **[Configuration](docs/02-configuration/01-configuration.md)** - Configure workflows, UI, and performance
- **[Usage Guide](docs/03-usage/)** - Workflows, details, and visual designer
- **[API Reference](docs/04-api/01-api-reference.md)** - Complete API documentation

Examples
--------

[](#examples)

Real-world examples are available in the [`examples/`](examples/) directory:

- **[Bug Tracking](examples/bug-tracking/)** - Issue lifecycle management
- **[Content Publishing](examples/content-publishing/)** - Content approval workflow
- **[Document Approval](examples/document-approval/)** - Multi-step approval process
- **[E-commerce Order](examples/ecommerce-order/)** - Order fulfillment workflow
- **[Employee Onboarding](examples/employee-onboarding/)** - New hire process

Testing
-------

[](#testing)

```
composer test
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance83

Actively maintained with recent releases

Popularity24

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 93.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~15 days

Total

7

Last Release

118d ago

PHP version history (2 changes)1.0.0PHP ^8.4

1.3.1PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/b57069d0f4b634f65eccc6e5d5848990e25968d45ec2cf46d626c6a4658f944b?d=identicon)[nasrulhazim.m](/maintainers/nasrulhazim.m)

---

Top Contributors

[![nasrulhazim](https://avatars.githubusercontent.com/u/10341422?v=4)](https://github.com/nasrulhazim "nasrulhazim (95 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (6 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")

---

Tags

laravelworkflowworkflow-enginelaravelworkflowstate-machineCleanique Codersflowstone

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/cleaniquecoders-flowstone/health.svg)

```
[![Health](https://phpackages.com/badges/cleaniquecoders-flowstone/health.svg)](https://phpackages.com/packages/cleaniquecoders-flowstone)
```

###  Alternatives

[laravel/pulse

Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application.

1.7k12.1M99](/packages/laravel-pulse)[lunarstorm/laravel-ddd

A Laravel toolkit for Domain Driven Design patterns

17959.0k](/packages/lunarstorm-laravel-ddd)[bezhansalleh/filament-plugin-essentials

A collection of essential traits that streamline Filament plugin development by taking care of the boilerplate, so you can focus on shipping real features faster

27584.7k16](/packages/bezhansalleh-filament-plugin-essentials)[vormkracht10/laravel-mails

Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app.

24149.7k](/packages/vormkracht10-laravel-mails)[ralphjsmit/livewire-urls

Get the previous and current url in Livewire.

82270.3k4](/packages/ralphjsmit-livewire-urls)[jonpurvis/squeaky

A Laravel Validation Rule to Help Catch Profanity.

706.0k](/packages/jonpurvis-squeaky)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)