Pro Visual Builder

Early Access / Preview: dbflowlabs/filament-pro (currently 0.1.0-alpha.20) is not a stable release. APIs, editor UX, and publication flows may change between tags.

DBFlow Pro adds a visual workflow builder for authoring DBFlow definitions. It sits on top of Core (dbflowlabs/core) and Filament Standard (dbflowlabs/filament). Core still executes workflows; Pro helps you design the JSON-compatible definitions Core runs.

┌─────────────────────┐     compile      ┌──────────────────────────┐
│  LogicFlow canvas   │ ───────────────▶ │  Core definition JSON    │
│  (ProCanvasField)   │   parse + compile│  schema_version: 1.0     │
└─────────────────────┘                  └──────────────────────────┘
         │                                           │
         │                                           ▼
         │                                 ┌──────────────────────────┐
         └────────────────────────────────▶│  DBFlow::start / approve │
                                           │  (unchanged runtime)     │
                                           └──────────────────────────┘

What Pro does

Layer	Package	Role
Runtime	`dbflowlabs/core`	Starts instances, creates tasks, evaluates `transitions[].condition`, writes logs
Operations	`dbflowlabs/filament`	My Tasks, instances, Standard `WorkflowResource` editor
Design (Preview)	`dbflowlabs/filament-pro`	LogicFlow canvas, graph JSON, compilation into Core definitions

Visual graphs are parsed and compiled through:

WorkflowGraphJsonParser — reads canvas graph JSON
ProGraphBlueprintCompiler — produces Core-compatible definition arrays

The compiled output must match the same schema documented in Code-defined Workflows. Pro does not introduce a separate runtime.

Namespace and bootstrap

Item	Value
Package	`dbflowlabs/filament-pro`
Namespace	`DbflowLabs\FilamentPro`
Service provider	`DBFlowFilamentProServiceProvider`

Install and asset steps are in Installation.

Good use cases (today)

Visualize approval chains before or after code-defined work
Edit simple linear approval graphs with developer oversight
Inspect refund and procurement demo flows in dbflow-demo
Developer-assisted design — product/engineering pairs reviewing topology together

The dbflow-demo project includes ProCanvasSandboxPage at /admin/pro-canvas-sandbox for local canvas testing with refund / procurement fixtures.

Not a fit for

Mature no-code production changes by non-technical staff without developer review
BPMN modeling or enterprise process notation
AI-generated workflow design
Replacing PHPUnit, WorkflowDefinitionValidator, or code review
Changing task approval semantics — DBFlow::approve() and DBFlow::reject() behave the same

Relationship to Standard UI

Filament Standard operates workflows (tasks, instances, timelines). Pro designs definitions through ProCanvasWorkflowDefinitionEditorResolver, registered via Standard's workflow_definition_editor_resolver hook. See Standard Integration.

Before you adopt Pro

Ship at least one workflow on Core + Standard first.
Read Preview Limitations.
Treat every compiled graph as draft until validated and tested.

What's next

ProCanvasField → — the Filament form field and canvas assets
Standard Integration → — resolver wiring and compilation pipeline
Preview Limitations → — alpha risks and deferred features
Filament UI → — Standard operational surfaces