# FlowDrop Documentation

**Visual Workflow Automation for Drupal**

FlowDrop is a powerful visual workflow editor for Drupal that enables you to build, execute, and monitor complex automation workflows without writing code. Using an intuitive drag-and-drop interface, you can create sophisticated data processing pipelines, AI-powered automation, and event-driven workflows.

Think of it as [n8n](https://n8n.io/) or [Langflow](https://www.langflow.org/) but fully integrated with Drupal — leveraging your existing entities, users, and content.

![FlowDrop visual workflow editor](screenshots/workflow-with-triggers.png)

---

## Choose Your Path

### For Sitebuilders

Build workflows visually without writing code.

- **[Installation](getting-started/installation.md)** — Install FlowDrop on your Drupal site
- **[Quick Start](getting-started/quick-start.md)** — Create and run your first workflow in 5 minutes
- **[Your First Workflow](getting-started/first-workflow.md)** — Guided tutorial building a real workflow
- **[Key Concepts](getting-started/concepts.md)** — Understand workflows, nodes, edges, and more
- **[Node Reference](guide/nodes/index.md)** — Detailed documentation for all built-in nodes
- **[Execution Modes](guide/execution-modes.md)** — Synchronous, async, and stateful orchestration
- **[Setting Up Triggers](guide/triggers.md)** — Automate workflows with event-driven triggers
- **[Human-in-the-Loop](guide/human-in-the-loop.md)** — Pause workflows for user input and approvals
- **[Monitoring Workflows](guide/monitoring-workflows.md)** — Track execution and debug failures
- **[Troubleshooting](guide/troubleshooting.md)** — Common issues and solutions

### For Developers

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

- **[Developer Quick Start](development/quick-reference/getting-started.md)** — Set up a development environment
- **[Create a Node Processor](development/quick-reference/define-node.md)** — Build custom nodes with PHP
- **[Node Processor Plugin System](development/flowdrop-node-processor.md)** — Deep dive into the plugin system
- **[Create a Custom Trigger](development/custom-triggers.md)** — Define new event types to fire workflows
- **[Create a Custom Orchestrator](development/custom-orchestrators.md)** — Build custom workflow execution strategies
- **[Testing Node Processors](development/testing-node-processors.md)** — Write PHPUnit tests for custom nodes
- **[Architecture](reference/architecture/flowdrop-erd.md)** — Entity relationships and system design

### For Site Builders

Deploy and maintain FlowDrop in production.

- **[Configuration Management](getting-started/configuration-management.md)** — Export and deploy workflows with `drush cex/cim`
- **[Upgrading FlowDrop](getting-started/upgrading.md)** — How to update between versions
- **[Production Deployment](guide/production-deployment.md)** — Queue workers, performance, and operational guidance

---

## Feature Highlights

- **25+ Built-in Node Processors** — Data processing, control flow, entity operations, HTTP, AI integration, and more
- **Event-Driven Triggers** — Automatically execute workflows on entity changes, user events, or cron
- **Human-in-the-Loop** — Pause workflows for user confirmations, choices, or text input
- **Multiple Execution Modes** — Synchronous, asynchronous (queue-based), and stateful orchestration
- **Real-Time Monitoring** — Track workflow execution with detailed pipeline and job status
- **Nested Workflows** — Execute workflows from within other workflows
- **AI Integration** — Connect to OpenAI, Mistral, and other AI providers

---

!!! info "Beta Release"
    FlowDrop 1.0.0-beta2 is available. The public API is frozen for the 1.x release line. See the [Backward Compatibility Policy](reference/api/bc-policy.md) for stability guarantees and the [API Reference](reference/api/index.md) for the full public API surface. Check the [Changelog](../CHANGELOG.md) for recent changes.
