bpmn-surf — visual BPMN/DMN diff for GitLab and GitHub
- 56 users
- 5.004 ratings
- #8,277in Developer Tools
Review BPMN/DMN changes in merge and pull requests as diagrams. Jump to Camunda 7/8 code, dive into called diagrams, edit and view.
by Kao Alllex · 1 listing
- Users
- 56
- #8,277 of 31,410 in category
- Rating
- 5.00
- 4 ratings · median 4.63
- Version
- 1.4.0
- 1023 KiB · Manifest V3
- Access
- Low14/100
- 2 permissions
Description
As written by the publisher on the storebpmn-surf shows BPMN 2.0 and DMN files in GitLab and GitHub as diagrams instead of XML, highlights exactly what a merge or pull request changed in them, and takes you from a task to the code behind it. Camunda 7 and Camunda 8 (Zeebe) diagrams alike.
- COMPARE CHANGES
- A "Schema diff" / "Decision diff" button on every .bpmn and .dmn file of a merge request or pull request opens a visual diff: added elements in green, removed in red, changed in blue
- Pinpoints the change inside an element: sequence-flow conditions, input/output mappings, decision table cells and rules
- Changes to the process itself, to pools and message flows are shown too
- Collapsed subprocesses are outlined when something inside them changed
- A list of changes: what changed in each element and connection; click an entry to jump to it. It follows the level on screen, a collapsed subprocess with changes inside being one entry
- Switch between the merge request version and the target branch version
- Diff a single commit (or a range of commits of a pull request), or a repository file against a local file
- FROM THE DIAGRAM TO THE CODE
- Jump from a service task to its handler code: external task, Java delegate or Camunda 8 job worker; a handler the merge request changed opens its diff there
- The same for execution and task listeners (Camunda 7 class or delegate, Camunda 8 job worker): one badge per listener, named by its event
- Jump from a message-waiting element to the code that correlates the message
- Dive from a call activity into the called process, or from a business rule task into the DMN decision, and step back; list every diagram that calls the one on screen
- Uses the platform's own code search in your session — no token needed (on gitlab.com and github.com code search needs a signed-in account)
- ALSO A VIEWER
- A "View schema" / "View decision" button opens any .bpmn or .dmn file in the repository as a diagram
- Properties panel for Camunda 7 and Camunda 8, with readable conditions (JUEL and FEEL); the groups touched by a change are highlighted
- Search elements by name, id or parameters (Ctrl/Cmd+F)
- Zoom, pan, fit to view, download any shown version
- EDIT A BPMN DIAGRAM
- Open the shown diagram in an edit mode in a separate tab, see your edits colored against the starting version, and download the result as a .bpmn file. Nothing is ever written back to the repository.
- WHERE IT WORKS
- gitlab.com and github.com, public and private repositories
- Self-managed GitLab and GitHub Enterprise Server
- Nothing is on by default: add the sites you use in the extension popup, and Chrome asks for access to that one site
- The handler annotations are configurable (defaults: @ExternalTaskSubscription, @JobWorker); settings can be exported to a file and imported by a colleague
- PRIVACY
- Diagrams are loaded from your GitLab or GitHub in your existing browser session and processed locally in your browser
- No analytics, no telemetry, no third-party servers, no remote code
- The extension never asks for passwords or tokens
- Privacy policy: https://github.com/kaoalllex/bpmn-surf/blob/master/PRIVACY.md
Open source (MIT): https://github.com/kaoalllex/bpmn-surf
Bug reports and ideas: https://github.com/kaoalllex/bpmn-surf/issues
Ratings and reviews
Ratings as the store shows themNo written reviews held for this listing yet.
Track bpmn-surf on Radar
This page shows the listing as it is today. Add it to Radar and get one email when it changes.
- Users and rating
- Store text and screenshots
- Permissions it asks for

bpmn-surf, in plain words
What it is, what to use instead, what it can access and how to fix it.
bpmn-surf at a glance
bpmn-surf — visual BPMN/DMN diff for GitLab and GitHub is a Developer Tools extension by Kao Alllex with 56 users. Chrome Web Store users rate it 5.00 out of 5 from 4 ratings, which is still a small sample. By users it sits in the top half of Developer Tools extensions.
- By users
- #8,277of 31,410 in Developer Tools
- Rating
- 5.00category median 4.63
- Access
- Low14 of 100
bpmn-surf alternatives
Closest by what they do · users as the store shows them · bars on a log scaleIs bpmn-surf safe?
bpmn-surf asks for 2 permissions. None of them are on our list of wide-access permissions.
Permissions show what it could do, not what it does. See the full permission list.
scriptingNot on our wide-access liststorageNot on our wide-access list
Every permission bpmn-surf asks for
2 permissions · none sensitive · Low access overallBrowser permissions · 2
- Run its code on pages it can access
scripting - Save its own settings
storage
Sensitive marks access that reaches your data or other sites. The access level is a 0 to 100 score of all of it: under 25 is Low, 60 and up is High.
bpmn-surf not working?
What recent reviews say
Store reviews from the last 90 daysWe have no recent public signals of problems with bpmn-surf.
Common fixes
Try them in this order- 1Update Chrome and the extension
- 2Turn it off and on in chrome://extensions
- 3Reload the page
- 4Turn other extensions off in case two clash
Still stuck? Contact the maker or try an alternative.
Know when a listing changes
Track any extension on Radar: users, rating, permissions and store text, with one email when something moves.