Pull Requests

Flowable Design allows you to create pull requests (or merge requests on GitLab) directly from the Git panel. This enables code review workflows for model changes without leaving the Design environment.

Creating a Pull Request

To create a pull request:

1. Ensure all your changes are committed on the current branch.
2. Open the Git panel on the app details page.
3. Click Create PR.
4. Select the target branch that you want to merge into (e.g., main).
5. Enter a title and description for the pull request.
6. Review the PR preview showing all changed models.
7. Click Create to submit the pull request to the Git hosting platform.

PR Preview

Before submitting the pull request, Design generates a preview that shows:

• A list of all models that differ between the source and target branches.
• Per-model visual diffs showing exactly what changed.
• Any conflicts that need to be resolved before the PR can be created.

The preview uses the same visual diff engine as the Compare and Diff feature, providing model-type-specific diffs for BPMN diagrams, forms, data dictionaries, and other model types.

Conflict Resolution in Pull Requests

If the source and target branches have conflicting changes, Design detects this during the PR preview:

1. Conflicting models are highlighted in the preview.
2. For each conflict, you can view the diff between the source and target versions.
3. Choose a resolution for each conflicting model (accept source or target version).
4. After resolving all conflicts, the pull request can be created with the resolutions applied.

See Conflict Resolution for more details on resolving conflicts.

After Creating the PR

Once the pull request is created, it exists on the Git hosting platform (GitHub, GitLab, or Bitbucket). From there:

• Team members can review the changes through the hosting platform's PR interface.
• CI/CD pipelines can be triggered on the PR.
• The PR can be merged through the hosting platform's merge controls.
• After merging, switch to the target branch in Design and pull to get the merged changes.

info

Pull request review and merging happen on the Git hosting platform, not within Flowable Design. Design creates the PR, but the review and merge workflow follows your team's standard Git practices.

Provider Support

Pull request creation is supported for the following provider types:

Provider	PR Type
GitHub	Pull Request
GitLab	Merge Request
Bitbucket	Pull Request