EzFlowEzFlow Docs
Building Workflows

Read-only diffs

Viewing a committed version or pull-request diff as a non-editable canvas.

When you navigate to a specific commit or pull request in the versioning system, EzFlow opens the Workflow in a read-only canvas. This gives you a visual overview of the graph at that point in history so you can understand what changed between versions.

What the read-only canvas shows

The read-only canvas renders the exact same node cards and variable edges as the live editor, using the same visual style — the same colours, the same handle indicators, the same edge types. The difference is that:

  • Nodes cannot be dragged — their positions are fixed.
  • New connections cannot be drawn — handles are display-only.
  • No changes are possible — there is no commit action available.

You can still pan the canvas by dragging the background, zoom with the scroll wheel or a pinch gesture, and click nodes to inspect them. The view fits all nodes into the window automatically when it first loads.

How to access a diff

Diffs are part of the versioning system. To view one:

  1. Open Environments in the sidebar and select an environment.
  2. Navigate to the Commits or Pull Requests tab.
  3. Click a commit or pull request to open its detail view.
  4. The read-only canvas loads the Workflow state recorded at that point.

For background on how EzFlow versions Workflows — branches, commits, pull requests, and environment promotion — see Versioning.

Using diffs for review

The read-only view is useful when:

  • Reviewing a pull request — compare the proposed graph against what you know should be there.
  • Auditing a past commit — see exactly what the engine ran at a given point in time.
  • Debugging a regression — trace when a node or connection was added or removed by comparing commits.

Because the canvas is fully navigable, you can zoom into complex parts of the graph, select nodes to read their labels, and trace edge paths without risk of accidentally editing anything.

On this page