> ## Documentation Index
> Fetch the complete documentation index at: https://docs.areawp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflow Builder

> Visual node-based automation builder — automate deployments, scripts, notifications, and conditional logic without code.

<Info>
  **Path:** Workflow (`/workflow`) — Admin only

  The 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.
</Info>

## Toolbar

At the top of the builder:

| 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

1. Connect nodes by dragging from one node's output handle to another's input
2. Configure each node (double-click to open settings)
3. Click **Save** — the "Saved View" badge appears
4. 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 |

<Tip>
  Workflows that fail 3 times in a row are automatically paused. Check the history to diagnose before re-enabling.
</Tip>