Replexica Docs

Appearance

CI/CD Action Integration ​

Replexica integrates with major code hosting platforms and their CI/CD systems to automate your localization workflow. We currently support:

Each platform has its own CI/CD system with unique features and syntax, but they all achieve the same goal: automating your translation updates as part of your development workflow.

How It Works ​

Regardless of which platform you use, Replexica's CI/CD integration follows the same core process:

  1. Runs replexica i18n to find and translate missing strings
  2. Commits changes to your repo
  3. Either pushes the commit directly or creates a pull request

This happens automatically on every push or pull request, keeping your translations up-to-date without manual intervention.

Why Use CI/CD Integration ​

Replexica's CI/CD integration solves a common problem in software development: keeping translations in sync with your rapidly evolving codebase. Here's why it's useful:

  1. Consistency: By running on every push, it ensures your translations are always in sync with your source code. This consistency is hard to maintain manually, especially in fast-moving projects.

  2. CI/CD Integration: It fits seamlessly into your existing CI/CD pipeline. This integration means localization becomes a natural part of your development process, not an afterthought.

  3. Version Control: All translation changes are committed and pushed, giving you a clear history of when and how translations were updated. This traceability is valuable for debugging and auditing.

Common Considerations ​

While each platform has its specific setup requirements, keep these general points in mind:

  1. Branch Strategy: When not using pull requests, the integration commits directly to the current branch. Ensure this aligns with your branching strategy. This direct commit approach is faster but might not suit teams with strict code review policies.

  2. Authentication: Each platform requires proper authentication for creating pull requests and pushing changes. Make sure you've configured the necessary tokens and permissions as described in the platform-specific guides.

  3. Customization: All platforms support customizing commit messages and pull request titles to match your team's conventions.

By automating localization with Replexica's CI/CD integration, you're treating translations as a first-class citizen in your development process. This approach leads to more consistent, up-to-date multilingual applications with minimal manual effort. It's particularly beneficial for teams working on rapidly evolving products where keeping translations in sync can be a significant challenge.

Technical Overview ​

Here's a breakdown of how the integration works across all platforms:

  1. It runs npx replexica@latest i18n to process translations.
  2. It stages all changes (git add .).
  3. If there are staged changes, it either:
    • Commits them, pulls and rebases to avoid conflicts, and pushes the changes; or
    • Creates or updates a pull request with the changes.

This process ensures that translation updates are seamlessly integrated into your codebase. The integration uses this approach because it allows for automatic conflict resolution (via rebase) and provides a clear audit trail of translation updates.

Available platforms ​

Choose your platform below to see detailed setup instructions: