Setup and Configuration
You will be redirected to GitLab to authorize the WunderGraph Hub application.
Grant the necessary permissions (
api, read_repository, write_repository) to allow the integration to manage your projects.Now you can navigate to any of your graphs, click on the dropdown on the top left corner, select "Integrations" and select "Git".

Merge Request Lifecycle
The GitLab integration automatically synchronizes merge request states with your schema proposal status, ensuring your development workflow stays aligned with your schema management process. Merge Request State Management:| State | Behavior |
|---|---|
| Ready for Review | When a proposal is created in opened state, a merge request is automatically created in “ready for review” state across all mapped projects. |
| Draft | When a proposal is moved to draft state, the merge request transitions to draft state. |
| Closed | When the proposal is closed, the corresponding merge request is also closed. |
| Reopened | If a closed proposal is reopened, the merge request is also reopened. |
How It Works
Streamlined Development Workflow
The GitLab integration eliminates the friction between schema design and implementation by automatically creating branches in your mapped projects whenever a schema proposal is made. This means developers can immediately start implementing changes without manual setup.Automatic Merge Request Creation
When a schema proposal is created in the hub, the integration automatically:- Creates a new branch in the mapped project
- Stores the proposed schema files directly in the branch
- Creates a merge request with the schema changes on new changes after creating a proposal or by opening the proposal.

