README

⭐ 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

• 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)

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

make -C demo up-symfony8

Open http://localhost:8022 — try the CRUD at /workflow and playgrounds for orders/documents.

Documentation

• Installation
• Configuration
• Usage
• Contributing
• Changelog
• Upgrading
• Release
• Security
• Engram
• Spec-driven development

Additional documentation

• Demo with FrankenPHP

Tests and coverage

make test
make test-coverage

License

MIT — see LICENSE.