What is Voodflow?

Voodflow is a visual workflow automation plugin for FilamentPHP that brings the experience of self-hosted workflow automation platforms directly inside your Laravel application.

Unlike SaaS automation platforms, Voodflow runs entirely on your infrastructure. Your workflows, your data, and your credentials never leave your servers.

Key Principles

Data Sovereignty

All workflow definitions, execution history, credentials, and runtime data are stored in your own database. There are no external services involved in the execution pipeline. This makes Voodflow suitable for environments with strict data privacy requirements (GDPR, HIPAA, NDA-bound data, etc.).

Self-Hosted by Design

Voodflow requires no Voodflow account, no API keys to a central server, and no internet connectivity to run workflows. It is a pure Laravel package that executes entirely in your PHP process or queue workers.

AI Model Freedom

Because HTTP requests are a first-class node type, Voodflow can connect to any AI model:

• Any LLM provider exposed via an HTTP API
• Local models via your preferred local runtime
• Any custom fine-tuned model behind an HTTP endpoint

FilamentPHP Native

Voodflow registers its own Filament resources and pages via a plugin class. It integrates with the Filament panel's navigation, auth, and theming out of the box.

Use Cases

Domain	Example
Marketing Automation	Schedule weekly blog posts, generate SEO meta with AI, publish to CMS
CRM Workflows	Trigger follow-up emails on deal status changes, score leads automatically
Data Pipelines	ETL jobs: fetch → transform → validate → persist → notify
AI Orchestration	RAG pipelines, content review, summarization, classification
E-commerce	Order → fulfill → invoice → send receipt → update inventory
Reporting	Aggregate sales data daily, render HTML report, send via email
Webhooks	Receive payment/repository/team events, process, respond with custom HTTP responses
DevOps Notifications	Notify via chat/email when deployments succeed or monitoring thresholds are breached

How It Works

Voodflow models an automation as a directed acyclic graph (DAG) of nodes:

1. A trigger node starts execution — either on a schedule, a Laravel event, an incoming webhook, or manually.
2. Each subsequent action/data node receives the output of the previous node as its input, processes it, and passes its output to the next node(s).
3. Flow-control nodes (If, Switch, ForEach, Merge) branch, loop, or join execution paths.
4. The execution engine traverses the graph depth-first, recording the result of every node in the database for full observability.

[Schedule Trigger]
      │
      ▼
[Data Model]  ──  SELECT orders WHERE status = 'completed' AND date > yesterday
      │
      ▼
[Filter]  ──  WHERE total > 1000
      │
      ▼
[For Each]  ──  iterate over each order
      │
      ├──▶ [HTTP Request]  ──  POST to AI API for sentiment analysis
      │          │
      │          ▼
      │    [Transform]  ──  extract { score, label } from AI response
      │          │
      └──────────▼
[Merge]  ──  collect all results
      │
      ▼
[Send Mail]  ──  send HTML report email

Compatibility

Package	Supported Versions
PHP	≥ 8.1
Laravel	v10, v11
FilamentPHP	v4, v5 (coming soon)
Livewire	v3
Database	MySQL 8+, PostgreSQL 14+, SQLite 3.35+

Node Categories

Voodflow currently includes 28 available nodes (27 executable + 1 editor utility):

• Triggers (4 nodes) — Start a workflow on a schedule, event, webhook, or manual click
• Actions (2 nodes) — Send emails and webhooks to external systems
• Flow Control (6 nodes) — Branch, loop, merge, delay, and catch errors
• Data (10 nodes) — Query, mutate, filter, transform, aggregate, and validate data
• Integrations (2 nodes) — HTTP requests and responses
• Notifications (1 node) — Send Filament database/broadcast notifications
• Utilities (2 nodes) — PHP code execution and data inspection
• Editor Utility (1 node) — Sticky Note canvas annotation (not executed)

See the Nodes Reference for the full catalogue.