Getting Started
GitHub Integration
Connect Babelize to your GitHub repositories.
Babelize integrates directly with GitHub to read your source code and raise pull requests with translations.
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 (all or specific repos)
- Click Install
You can change repository access anytime from your GitHub Settings → Applications → Babelize.
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 Required
Babelize requests the minimum permissions needed:
- Repository contents — read access to scan your code
- Pull requests — write access to create translation PRs
- Metadata — read access for repository information
Sync with GitHub
When your source code changes, you can keep translations up to date:
- Open your project in the dashboard
- Click Sync to pull the latest changes from GitHub
- Run Babelize again to translate new or modified strings
The sync button shows the status:
- Synced — your project is up to date
- Behind — your repository has new commits
- Reconnect — GitHub access needs to be re-authorized
Troubleshooting
"GitHub Authentication Failed"
- Go to your Profile settings
- Check if GitHub is connected
- If not, re-authorize via Connect GitHub
"Failed to raise PR"
- Verify the Babelize GitHub App is installed on the repository
- Check that 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