⭐ 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.4+ (PHP 8.2+) and 8.x (PHP 8.4+) — tested on Symfony 7.4, 8.0, and 8.1+.
This bundle is FrankenPHP worker mode friendly.
Definitions list — match rules, priority and row actions |
Definition detail — flow diagram of a branching state machine |
Transitions editor — dialog with searchable from / to places |
- Persist workflow definitions (places, transitions, subject class, marking property) in Doctrine
- Configurable Doctrine
table_prefixfor table and constraint names - Built-in admin UI at
/workflow(configurable path), protected by default viasecurity.access_roles/WorkflowUiAccessPolicyInterface - Admin pages on the UiKit 2.1 page contract (REQ-UI-003): list, show, form, settings and dashboard scaffolds themed once by the host (
nowo_ui_kit.layouts/nowo_ui_kit.theme), flow diagram and collection editors on native<dialog>s, no CDN assets — see Templates - Configurable
web_ui.path_prefix,web_ui.layout_template,web_ui.templates.<page>andweb_ui.list_page_size - UI translations for
en,es,fr,it,de,nl,pt(enable extra locales inweb_ui.locales) - Runtime resolution via
DatabaseWorkflowRegistry(Symfony Workflow component) WorkflowRuntimeInterface/WorkflowApplicatorto apply transitions (your code persists the subject;runtime.flush_after_apply: truelets the bundle flush it)- Optional header search (SearchKit 1.10+, PHP 8.3+): one group per request type finds your workflow requests by a search text and their status, only those your access rules let the viewer see — see Usage
- Demo with order approval (state machine) and document review (parallel workflow)
- FrankenPHP worker mode: Supported (including kernel not reset between requests; see Demo with FrankenPHP and Worker audit)
composer require nowo-tech/workflow-bundle# config/packages/nowo_workflow.yaml
nowo_workflow:
web_ui:
path_prefix: '/workflow'
# layout_template: null → nowo_ui_kit.layouts.admin (your layout / bridge, set once in UiKit)
security:
access_roles: [ROLE_ADMIN]php bin/console nowo:workflow:sync-schema
php bin/console nowo:workflow:seed-demo # optional sample definitionsmake -C demo up-symfony8Open http://localhost:8022 — try the CRUD at /workflow and playgrounds for orders/documents.
Playwright e2e and the README screenshots (REQ-DEMO-013): make -C demo/symfony8 test-e2e and
make -C demo/symfony8 demo-screenshots (after make -C demo/symfony8 reset-demo).
Smoke check (boot + HTTP 200):
make demo-smoke- Installation
- Configuration
- Usage
- Contributing
- Code of Conduct
- Changelog
- Upgrading
- Release
- Security
- Engram
- Spec-driven development
- GitHub Spec Kit
- Usage: standard Symfony host
- Usage: DDD / hexagonal host
- Multitenant workflows (1.15: per-organization definitions, versions, guards, audit)
- Concurrency (safe concurrent applies, conflict codes, REQ-RUNTIME-003)
- Architecture (ports, SPI, events, standard Symfony and DDD hosts, REQ-ARCH-001)
- Templates (UiKit page contract)
- PSR evaluation (REQ-CS-007)
- Demo with FrankenPHP
- FrankenPHP worker audit (no kernel reset)
- GitHub Actions CI requirements
| Area | Coverage / status |
|---|---|
| PHP | 100% (statement coverage gate: make coverage-check and composer test-coverage-100 in CI) |
| TS/JS | N/A (the only shipped script, src/Resources/public/js/nowo-workflow.js, is hand-written and has no Vitest suite; the admin UI is exercised by the demo Playwright e2e under demo/symfony8/e2e) |
| Python | N/A |
Tests summary: PHPUnit unit and integration suites (tests/Unit, tests/Integration).
make test
make test-coverage


