Introduction

LetsFlow · the workflow engine developers love

LetsFlow is a workflow engine for running processes, described in YAML or JSON.

YAML

schema: "https://specs.letsflow.io/v0.3.0/scenario#"
title: My first scenario

actors:
  user:
    title: The user

actions:
  complete:
    title: Complete the process

states:
  initial:
    on: complete
    goto: (success)

JSON

{
    "schema": "https://specs.letsflow.io/v0.3.0/scenario#",
    "title": "My first scenario",
    "actors": {
        "user": {
            "title": "user"
        }
    },
    "actions": {
        "complete": {
            "title": "Complete the process"
        }
    },
    "states": {
        "initial": {
            "action": "complete",
            "transition": "(success)"
        }
    }
}

JSON (full)

{
    "$schema": "https://specs.letsflow.io/v0.3.0/scenario#",
    "title": "My first scenario",
    "actors": {
        "user": {
            "$schema": "https://specs.letsflow.io/v0.3.0/actor#",
            "title": "user"
        }
    },
    "actions": {
        "complete": {
            "title": "Complete the process",
            "responses": {
                "ok": {
                    "title": null,
                    "display": "always"
                    "update": [ ]
                }
            }
        }
    },
    "states": {
        "initial": {
            "actions": [
                "complete"
            ],
            "transitions": [
                {
                    "on": "*.*"
                    "goto": "(success)"
                }
            ]
        }
    }
}

The scenario models a process as a fine-state machine. The actors are persons, organizations or systems that are allowed to participate in the process by performing actions. Which actions can be performed depends on the current state of the process. After an action has been, the process will transition to a different state.