FlowDrop Documentation¶

Workflow Orchestration for Drupal

FlowDrop is the workflow orchestration module for Drupal. It gives you everything you need to create, manage, run, and track flows — and more capabilities are added as the orchestration story grows. Visual, code-free, and fully integrated with the entities, users, and content you already have.

Where simple event-driven automation hides data flow behind keywords/configs, FlowDrop makes every connection explicit: typed ports, visible edges, traceable executions. The graph is the specification, the execution engine, and the audit trail in one.

Choose Your Path¶

For Sitebuilders¶

Build workflows visually without writing code.

• Installation — Install FlowDrop on your Drupal site
• Quick Start — Create and run your first workflow in 5 minutes
• Your First Workflow — Guided tutorial building a real workflow
• FlowDrop Vocabulary — Workflows, nodes, edges, ports, and the rest of the terminology
• Node Reference — Detailed documentation for all built-in nodes
• Execution Modes — Synchronous, async, and stateful orchestration
• Setting Up Triggers — Automate workflows with event-driven triggers
• Human-in-the-Loop — Pause workflows for user input and approvals
• Monitoring Workflows — Track execution and debug failures
• Troubleshooting — Common issues and solutions

For Developers¶

Extend FlowDrop with custom node processors, triggers, and orchestrators.

• Developer Quick Start — Set up a development environment
• Create a Node Processor — Build custom nodes with PHP
• Node Processor Plugin System — Deep dive into the plugin system
• Create a Custom Trigger — Define new event types to fire workflows
• Create a Custom Orchestrator — Build custom workflow execution strategies
• Testing Node Processors — Write PHPUnit tests for custom nodes
• Architecture — Entity relationships and system design

For Site Builders¶

Deploy and maintain FlowDrop in production.

• Configuration Management — Export and deploy workflows with drush cex/cim
• Upgrading FlowDrop — How to update between versions
• Production Deployment — Queue workers, performance, and operational guidance

What FlowDrop Does¶

FlowDrop covers the full lifecycle of workflow orchestration:

Create & Edit¶

A drag-and-drop visual editor with typed ports, color-coded data types, and visible edges. 25+ built-in nodes for data processing, control flow, entity operations, HTTP, and AI. Branching gateways, loops, and nested workflows built in.

Manage¶

Workflows are standard Drupal configuration entities — exportable to YAML, versionable in git, and deployable across dev/stage/prod with drush cex/cim. Node Types let site builders configure pre-set node variants without writing code.

Run¶

Three execution modes for any workload — Synchronous (in-request), Asynchronous (queue-based background), and StateGraph (checkpointed, resumable). Event-driven triggers start flows automatically on entity changes, user events, or cron. Human-in-the-loop nodes pause execution for confirmations, choices, or free-text input.

Track¶

Every run produces a pipeline record with one job per node — what ran, what data went in, what came out, how long it took, what failed. Real-time monitoring and per-node inspection in the admin UI.

API Stability¶

FlowDrop 1.x is the stable release line. The public API is frozen — see the Backward Compatibility Policy for stability guarantees and the API Reference for the full public API surface. Check the Changelog for recent changes.