Lingo.dev Docs

Appearance

Automate Translations with CI/CD Integration ​

Keep your translations in sync with your code automatically by integrating Lingo.dev into your CI/CD pipeline. We support all major code hosting platforms:

How CI/CD Integration Works ​

Regardless of platform, Lingo.dev's automation follows this streamlined process:

  1. Automatically detects and translates new or modified strings
  2. Commits translation changes to your repository
  3. Either pushes directly or creates a pull request

This automation runs on every code push or pull request, ensuring your translations stay current without manual intervention.

Key Benefits ​

1. Always-Current Translations ​

Your translations remain synchronized with your source code, even in fast-moving projects where manual updates would be impractical.

2. Seamless Workflow Integration ​

Localization becomes an integrated part of your development process rather than a separate task that might be overlooked.

3. Complete Version Control ​

All translation changes are tracked in your repository, providing clear history and accountability for debugging and auditing.

Implementation Considerations ​

Branch Strategy ​

When configured for direct commits, changes are pushed to the current branch. Ensure this aligns with your team's workflow or opt for the pull request approach for teams with strict code review requirements.

Authentication Setup ​

Each platform requires specific authentication for creating commits and pull requests. Follow the platform-specific guides to configure the necessary tokens and permissions.

Customization Options ​

All integrations support customizing commit messages and pull request titles to match your team's conventions and requirements.

Technical Implementation ​

The integration process works identically across all supported platforms:

  1. Executes npx lingodotdev@latest i18n to process translations
  2. Stages all changes to the repository
  3. For detected changes:
    • Either commits, rebases to resolve conflicts, and pushes directly
    • Or creates/updates a pull request with the changes

This approach ensures smooth integration with automatic conflict resolution while maintaining a clear audit trail of all translation updates.

Platform-Specific Setup ​

Select your platform for detailed configuration instructions: