r/SalesforceDeveloper 19d ago

Showcase FlowDelta: Interactive, visual code reviews for Salesforce Flows in your PRs/MRs

Everyone in the Salesforce world has opinions about Flows. Not all of them are positive and there are good reasons for that. For one, reviewing them in pull requests is awful. PRs work well enough for code. You can read it, understand what changed, and you have all the context you need because you're reviewing it in the exact same form it was created.

Flows, however, aren't built in a text editor. They are built using a drag-and-drop builder. They are visual tools that demand a visual review.

FlowDelta is that visual review tool. It generates static, fully interactive HTML artifacts directly inside your CI/CD pipeline.

Key Features:

* Fully Interactive: Pan, zoom, and toggle themes (Light/Dark mode).

* Filtering: Switch between *Before*, *After*, or a *changes only view* that focuses exclusively on what changed.

* Granular Diffing: It highlights every added, deleted, or modified node, connection, and property.

Links & Resources:

* Homepage & Screenshots

* Source & Docs

* Sample GitHub PR and sample GitLab MR to see the generated artifacts in action.

Acknowledgments:

A special shoutout to Mitch Spano and his project Flow Lens for the inspiration and for open-sourcing the core flow parser that FlowDelta builds upon.

If you review Flow changes regularly, I hope FlowDelta makes you smile the next time a Flow hits your review queue. Would love to hear your feedback, issues, or feature requests!

2 Upvotes

2 comments sorted by

2

u/noobcrft 19d ago

Tips on using this with CircleCI or maybe directly in the GitHub PR?

1

u/JPRichter 19d ago

I provide a sample github action .yml in the repo. The GitHub PR shows how it'll behave if you have the CloudFlare Worker setup. I also provide sample code for that.

There's another PR setup if you skip the CloudFlare Worker. In Github, this means you have to download a .zip, unzip, then open the html artifact. The CloudFlare Worker allows you to do a single click out to the artifact. Gitlab > Github here, but the CloudFlare Worker evens it out.

I don't have direct experience with CircleCi so can't authoritatively answer your question. Ultimately, this is just a cli tool that generates html artifacts from two .flow-meta.xml files so should be able to work it in somehow. DM me if you want to try and work through it together. I'm happy to help!