Our experience, knowledge and lessons learned - all here just for you.
GitHub is one of the most beloved development platforms and repository hoster. Although it is possible to use LingoHub with manual file upload and over the REST API, we created a premium experience for integrating with GitHub that allows you to:
- Synchronize resource files back and forth between LingoHub and your repository
- Directly push the changes or create a Pull Request
- Custom commit message/Custom Pull Request information
- Instant, periodic or manual synchronization
Note: The LingoHub app was specifically made with the intention to have the least possible permissions to your repository. We understand how important security and trust are.
Once you created your LingoHub project, you can create a GitHub integration in the
You know have 2 options:
- Install the LingoHub App on your GitHub account
- Go to the next step if the LingoHub App is already installed.
Install LingoHub App
Clicking the green button
Install LingoHub on GitHub will redirect you to GitHub to install the app. There you will find a dialog that allows you to specify if the app should be installed for the entire organization or just for specific repositories.
Once the app installation was successful, you will be automatically redirected to LingoHub.
Connecting the repository
Now that LingoHub has access to the GitHub organization, it is time to specify which repository should be connected to your LingoHub project and what the
default branch is.
Note: The repository URL and the branch will be verified if they exist on GitHub and if LingoHub has access to them.
Selecting the resource files
The last configuration step is to select the files you wanna synchronize with LingoHub. For that LingoHub created a powerful file matcher. The file matcher works in two different modes:
simple is folder based and allows you to select a folder (with a dynamic part for the locales) that contains the resource files. The
advanced modus offers a
regex like matcher for unlimited flexibility. For more information about the Matcher, visit the help page (LINK).
Note: Always make sure that you specify the nearest folder that contains the files because otherwise, GitHub's API can report problems like timeouts or rate limits exceeded.
Now you only have to click the
Create Integration button and your integration is set up.