Skip to main content

GitHub integration

Written by Antonis Mylonas

Connect your GitHub repository to your project to automatically pull files instead of uploading them manually. Once connected, your files are translated automatically, and when translations for a language are ready, these are sent back to your repo instantly.


Installation and authentication

Start by going to your project's page and choosing to connect a GitHub repository.

Authorize access with your GitHub credentials, ensuring the integration has permission to read files and create PRs on your repo.

You will then install the xera GitHub application in either your personal account or in a GitHub organization that you are an administrator of.

Next, select which GitHub repository and branch to connect. Once enabled, the system will automatically pull these files from GitHub for translation.

Choose the files you want to sync automatically and enable the automatic translation feature to start translating files as they are pulled.

When all selected files are uploaded into xera, translation starts (provided you have enough words in your monthly allowance).


Managing the GitHub Integration

Once you've connected your GitHub repository to a xera project, you can manage which files are synced, how translation are pushed back, and monitor the translation status; all from within your project.


Manage GitHub Files

Click Manage GitHub β†’ Manage files to choose which files from your repository you want to sync with xera.

You can:

  • Browse folders and files in the selected branch

  • Select or deselect specific files (e.g., /src/myfile.json)

  • Confirm changes with Save & close

Files you select will be pulled into the project for translation. If there are any updates on already pulled files, new files will be created in your project for all these updates to get translated. The updated translations will be pushed back to your repo, relevant to the only file that was pulled in the first place.


Edit Settings

From Manage GitHub β†’ Edit settings, choose when xera should push translations back to your repo:

  • When the content is 100% translated (default)

  • When the content is 100% approved

  • When the content TQI meets a threshold (Coming soon)

These settings determine when xera creates a pull request (PR) with the translated file(s). When the selected condition is met (e.g., 100% translated), xera will:

  • Automatically create a pull request in the connected GitHub repository

  • Include the translated files per target language

  • Let you review and merge the PR into your codebase


Pause Syncing

If needed, you can temporarily pause syncing via the same menu. This halts file pulling and translation syncing without disconnecting the integration.


​

Did this answer your question?