FlowDelta

Salesforce + CI

Visual diffs for Salesforce Flows, right inside your code review workflow.

You need to understand the functionality or ui that changed in the Salesforce Flows of your team's Pull Requests. You shouldn't have to divine that from an XML diff. FlowDelta offers a visual, interactive, node-by-node, edge-by-edge diff, highlighting every added, deleted, or modified element and property. Now Salesforce Flows can get the reviews they deserve, in the same place your team reviews code.

View on GitHub View on npm

A FlowDelta artifact: a Salesforce Flow rendered as a node graph. A newly added fault path and its edges are highlighted green, a modified decision node is outlined orange, and the detail panel on the right lists the per-property change on the modified node.

The generated artifact is a readable, interactive diff. Pan, zoom, and click into changed nodes to see detailed property changes.

// what it does

Visual Diffs

See the real differences — nodes added, deleted, rewired, and every property that changed.

A self-contained artifact

Each flow becomes one interactive HTML file. Filter to After, Before, or Changes only, click any node for its property detail. No server, no build step — just open it in a browser.

Built for code review

CI reporters post a single sticky comment on GitLab MRs and GitHub PRs, with live-render links to the full artifact. Sample yaml you can copy into your CI configuration makes it easy to setup.

// per-node property deltas

Click any node and the panel breaks the change down to the property. Screen settings, decision outcomes, assignment operations, fault connectors — every field that moved is shown as added, removed, or changed, grouped into the sections that make sense for that node type.

A FlowDelta artifact showing an added Screen node highlighted green, a deleted connector as a red dashed edge, and the detail panel expanding the new node's Screen Settings and Field properties.

See it live on a real pull request

Two example projects have FlowDelta wired into CI. Open a merge request or pull request and read the diff comment it posted — artifacts and all.

Sample GitLab MR Sample GitHub PR

// run it

FlowDelta runs as a CLI — compare two local files, or two git refs across a whole repo. Point the CI reporters at the output directory and they'll post the review comment for you.

terminal — flow-delta

# diff two local files, also emit machine-readable diff.json
$ npx flow-delta --old before.flow-meta.xml --new after.flow-meta.xml \
    --out ./flow-delta-out --json

# or diff every changed flow between two git refs
$ npx flow-delta --repo . --from main --to my-branch \
    --path 'force-app/**/*.flow-meta.xml' --changed-only --out ./flow-delta-out --json

# in CI: post a sticky review comment from the artifacts
$ flow-delta-gitlab --in flow-delta-out
$ flow-delta-github --in flow-delta-out

View on GitHub → View on npm →

Inspired by Google's Flow Lens, and vendors its Flow parser under the Apache 2.0 license; FlowDelta-authored code is MIT.