BPMN-TXT

Human-readable BPMN 2.0

Write business processes in a simple, text-based DSL. Export to standard BPMN XML.

Get Started View on GitHub(opens in new tab)

Human-Readable

YAML-like syntax that's easy to write, read, and version control. No XML editing required.

BPMN 2.0 Compatible

Exports to standard BPMN 2.0 XML that works with Camunda, Flowable, and other engines.

Automatic Layout

Smart auto-layout using ELK.js generates proper diagram coordinates automatically.

Fast CLI

Compile, watch, and validate from the command line. Integrates into any workflow.

Quick Example

process: order-process
  name: "Order Processing"

  start: order-received
    name: "Order Received"

  task: validate-order
    name: "Validate Order"
    type: service

  gateway: valid-check
    type: exclusive
    name: "Order Valid?"

  task: fulfill-order
    name: "Fulfill Order"
    type: user

  end: completed
    name: "Order Complete"

  flow: f1
    from: order-received
    to: validate-order
  flow: f2
    from: validate-order
    to: valid-check
  flow: f3
    from: valid-check
    to: fulfill-order
    condition: "valid == true"
  flow: f4
    from: fulfill-order
    to: completed

Compile with:

bpmn-txt compile order.bpmn.md -o order.bpmn