GitHub Integration

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

Installing the GitHub App

1. Go to Projects → New Project
2. Click Connect GitHub
3. Install the Babelize GitHub App on your account or organization
4. Select which repositories Babelize can access
5. Click Install

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

How It Works

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:

1. Open your project in the dashboard
2. Click Sync to pull the latest changes
3. 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"

1. Go to your Profile settings
2. Check if GitHub is connected
3. 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