PHPackages                             nowo-tech/workflow-bundle - 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. [Database & ORM](/categories/database)
4. /
5. nowo-tech/workflow-bundle

ActiveSymfony-bundle[Database & ORM](/categories/database)

nowo-tech/workflow-bundle
=========================

Symfony bundle to define and run Symfony Workflow state machines from database definitions with built-in CRUD.

v1.2.0(yesterday)00MITPHPPHP >=8.2 <8.6CI passing

Since Jun 10Pushed yesterdayCompare

[ Source](https://github.com/nowo-tech/WorkflowBundle)[ Packagist](https://packagist.org/packages/nowo-tech/workflow-bundle)[ Docs](https://github.com/nowo-tech/WorkflowBundle)[ RSS](/packages/nowo-tech-workflow-bundle/feed)WikiDiscussions main Synced today

READMEChangelog (3)Dependencies (22)Versions (4)Used By (0)

Workflow Bundle
===============

[](#workflow-bundle)

[![CI](https://github.com/nowo-tech/WorkflowBundle/actions/workflows/ci.yml/badge.svg)](https://github.com/nowo-tech/WorkflowBundle/actions/workflows/ci.yml)[![Packagist Version](https://camo.githubusercontent.com/6fc05bb8ee325cfa7f04de9155aa954629d537e6890503a848d50bc8175e7ece/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6f776f2d746563682f776f726b666c6f772d62756e646c652e7376673f7374796c653d666c6174)](https://packagist.org/packages/nowo-tech/workflow-bundle)[![Packagist Downloads](https://camo.githubusercontent.com/4ae4a2b77e337d5e333081c837b1de163218f582fb0de4091ae542b91ed84a8c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6f776f2d746563682f776f726b666c6f772d62756e646c652e737667)](https://packagist.org/packages/nowo-tech/workflow-bundle)[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE)[![PHP](https://camo.githubusercontent.com/3f99b197569aa2dcfbefff17ecc68d74098e7f929d8b52dc40f3a898f740eae1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d3737374242343f6c6f676f3d706870)](https://php.net)[![Symfony](https://camo.githubusercontent.com/7d4e4aaeb2d34975bb7d4d31bd666f354efd01e011d1799c80335c7a7cd62e7a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d372e30253242253230253743253230382e302532422d3030303030303f6c6f676f3d73796d666f6e79)](https://symfony.com)[![GitHub stars](https://camo.githubusercontent.com/aae90056254ff892a994d5a129e9de76c227f7a1d72968c7c10e4edd7069b6ce/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e6f776f2d746563682f576f726b666c6f7742756e646c652e7376673f7374796c653d736f6369616c266c6162656c3d53746172)](https://github.com/nowo-tech/WorkflowBundle)[![Coverage](https://camo.githubusercontent.com/cd0704b56f1d56def350b6d0164316307bb2f47834225fd85443b6fb0059bc73/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f7665726167652d3130302532352d627269676874677265656e)](#tests-and-coverage)

> ⭐ **Found this useful?** Give it a star on GitHub! It helps us maintain and improve the project.

Define Symfony Workflow state machines and workflows in the database, manage them with a built-in CRUD UI, and execute transitions at runtime through `DatabaseWorkflowRegistry` and `WorkflowApplicator`.

> 📋 **Compatible with Symfony 7.x (PHP 8.2+) and 8.x (PHP 8.4+)**

Features
--------

[](#features)

- Persist workflow definitions (places, transitions, subject class, marking property) in Doctrine
- Configurable Doctrine `table_prefix` for table and constraint names
- Built-in admin UI at `/workflow` (configurable path), optionally protected via `WorkflowUiAccessCheckerInterface`
- Runtime resolution via `DatabaseWorkflowRegistry` (Symfony Workflow component)
- `WorkflowApplicator` helper to apply transitions and flush subjects
- Demo with order approval (state machine) and document review (parallel workflow)
- FrankenPHP demo with PostgreSQL (see [Demo with FrankenPHP](docs/DEMO-FRANKENPHP.md))

Quick start
-----------

[](#quick-start)

```
composer require nowo-tech/workflow-bundle
```

```
# config/packages/nowo_workflow.yaml
nowo_workflow:
    enabled: true
    ui:
        path: '/workflow'
```

```
php bin/console nowo:workflow:sync-schema
```

Demo
----

[](#demo)

```
make -C demo up-symfony8
```

Open  — try the CRUD at `/workflow` and playgrounds for orders/documents.

Documentation
-------------

[](#documentation)

- [Installation](docs/INSTALLATION.md)
- [Configuration](docs/CONFIGURATION.md)
- [Usage](docs/USAGE.md)
- [Contributing](docs/CONTRIBUTING.md)
- [Changelog](docs/CHANGELOG.md)
- [Upgrading](docs/UPGRADING.md)
- [Release](docs/RELEASE.md)
- [Security](docs/SECURITY.md)
- [Engram](docs/ENGRAM.md)
- [Spec-driven development](docs/SPEC-DRIVEN-DEVELOPMENT.md)

### Additional documentation

[](#additional-documentation)

- [Demo with FrankenPHP](docs/DEMO-FRANKENPHP.md)

Tests and coverage
------------------

[](#tests-and-coverage)

AreaCoveragePHP100%```
make test
make test-coverage
```

License
-------

[](#license)

MIT — see [LICENSE](LICENSE).

###  Health Score

42

—

FairBetter than 89% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 70% 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 ~10 days

Total

3

Last Release

1d ago

PHP version history (2 changes)v1.0.0PHP >=8.1 <8.6

v1.2.0PHP >=8.2 <8.6

### Community

Maintainers

![](https://www.gravatar.com/avatar/e7947bfc3f2ce9574a18a2c60f3d95b5d1b0740e65dc929332c92f1df21f75ab?d=identicon)[HecFranco](/maintainers/HecFranco)

---

Top Contributors

[![HecFranco](https://avatars.githubusercontent.com/u/24323276?v=4)](https://github.com/HecFranco "HecFranco (7 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")

---

Tags

symfonybundledatabasedoctrineworkflowcrudstate-machine

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nowo-tech-workflow-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/nowo-tech-workflow-bundle/health.svg)](https://phpackages.com/packages/nowo-tech-workflow-bundle)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.5M378](/packages/easycorp-easyadmin-bundle)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1615.6k12](/packages/2lenet-crudit-bundle)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M196](/packages/sulu-sulu)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.8M717](/packages/sylius-sylius)[open-dxp/opendxp

Content & Product Management Framework (CMS/PIM)

9417.2k58](/packages/open-dxp-opendxp)[chameleon-system/chameleon-base

The Chameleon System core.

1027.9k4](/packages/chameleon-system-chameleon-base)

PHPackages © 2026

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