Path: Workflow (/workflow) — Admin onlyThe Workflow Builder is a visual drag-and-drop automation tool built on React Flow. Create, save, and execute workflows that chain triggers, scripts, notifications, and conditional logic.
| Control | Description |
|---|
| Workflow name | Editable input for the current workflow |
| Saved View badge | Appears when the workflow has been saved |
| New | Start a blank workflow |
| Load | Open a previously saved workflow |
| Execute | Run the workflow (disabled if unsaved) |
| History | View execution history |
| Save | Save the current workflow with status feedback |
Node Palette
The left sidebar contains draggable nodes organized into three sections:
Triggers
Start a workflow in response to an event:
| Node | Description |
|---|
| Manual Trigger | Run on demand from the UI |
| Scheduled Task | Cron expression — run on a schedule |
| Webhook Trigger | Fires when an HTTP request is received |
| Event Listener | Responds to platform events (site deployed, user created, etc.) |
Actions
Execute work:
| Node | Description |
|---|
| Run Script | Execute a shell command on a server |
| Send Notification | Send email, webhook, or Slack message |
Flow Control
Control the execution path:
| Node | Description |
|---|
| If/Else | Branch based on a condition (exit code, variable value) |
Canvas
The main canvas is a React Flow editor with:
- Background grid for alignment
- Zoom / pan controls
- Mini-map for overview navigation
Node Color Coding
| Color | Node Type |
|---|
| Blue | Docker App, Trigger |
| Amber | Database |
| Green | Domain |
| Indigo | Service |
| Gray | Run Script |
| Purple | Send Notification |
| Orange | If/Else Logic |
Server Overview (Auto-Load)
When you open the Workflow Builder, it automatically loads your infrastructure as read-only nodes on the canvas — apps, domains, and databases positioned in a grid with connection lines showing relationships. Use this as a reference while building your automation, or as a live infrastructure map.
Saving and Executing
- Connect nodes by dragging from one node’s output handle to another’s input
- Configure each node (double-click to open settings)
- Click Save — the “Saved View” badge appears
- Click Execute to run the workflow immediately
Execution Progress Modal
Shows the result of each node step as the workflow runs — success/failure status and output for every action.
Execution History
Click History to see all past runs:
| Column | Description |
|---|
| Started | Timestamp |
| Duration | How long the workflow took |
| Status | Success / Failed / Partial |
| Details | Expand to see per-node output |
Workflows that fail 3 times in a row are automatically paused. Check the history to diagnose before re-enabling.
