GitHub Integration

Babelize integrates directly with GitHub to read your source code and raise pull requests with translated files.

Installing the GitHub App

Go to Projects → New Project
Click Connect GitHub
Install the Babelize GitHub App on your account or organization
Select which repositories Babelize can access
Click Install

You can change repository access anytime from GitHub Settings → Applications → Babelize.

No GitHub? Upload a ZIP

Projects don't require GitHub. In the same New Project flow choose Upload ZIP instead of Connect GitHub — translations are then downloaded as an archive from the project page rather than delivered as a PR.

How It Works

Action	What Babelize Does
Read	Clones the repo to scan for translatable content
Write	Creates a branch and opens a PR with translated files
Sync	Detects new commits and lets you re-run translations

Permissions

Repository contents — read access to scan your code
Pull requests — write access to create translation PRs
Metadata — read access for repository information

Syncing

When your source code changes, keep translations up to date:

Open your project in the dashboard
Click Sync to pull the latest changes
Run Babelize again to translate new or modified strings

Sync status indicators:

Synced — up to date with GitHub
Behind — new commits available
Reconnect — GitHub access needs re-authorization

Troubleshooting

"GitHub Authentication Failed"

Go to your Profile settings
Check if GitHub is connected
Re-authorize via Connect GitHub

"Failed to raise PR"

Verify the Babelize GitHub App is installed on the repository
Check you have write access to the repository
Try re-running from the project page

Repository Not Showing Up

Ensure the Babelize GitHub App has access to that repository
Go to GitHub Settings → Applications → Babelize and add the repo

On this page