Localization Guides
Max Prilutskiy·Updated about 1 month ago·2 min read
Each guide walks through a specific localization scenario end-to-end - from configuring a localization engine on Lingo.dev to shipping translated output in production. Every guide assumes you have an organization and at least one localization engine configured.
How Guides Work
Every product has different localization surfaces. A web app needs translated UI strings. An API needs localized responses. A documentation site needs translated Markdown files. Each surface connects to the same localization engine, but the integration pattern differs.
These guides cover seven integration patterns:
| Surface | What gets localized | Integration method |
|---|---|---|
| Translation API | Key-value data, dynamic content | HTTP API calls |
| Web apps | UI strings, component text | CLI + framework integration |
| Mobile apps | iOS .strings, Android .xml |
CLI + mobile build pipeline |
| iOS apps | Xcode String Catalogs .xcstrings |
CLI + GitHub Actions |
| Android apps | Android strings.xml |
CLI + GitHub Actions |
| Emails | Transactional and marketing templates | API or CLI depending on template format |
| Static content | Markdown, JSON, YAML files | CLI with file-based translation |
| CI/CD workflows | All of the above, automated | GitHub Actions, GitLab CI, Bitbucket Pipelines |
Prerequisites
All guides require an API key and a configured localization engine. If you haven't set these up yet, start with the documentation.
Choose Your Guide
Translation API\n\nSend key-value data to the localization API and get translations back programmatically
Web App\n\nLocalize React, Next.js, and other web frameworks using the CLI
Mobile App\n\nLocalize iOS and Android applications with per-locale model selection
iOS with String Catalogs\n\nEnd-to-end Xcode .xcstrings localization with CLI and GitHub Actions
Android with strings.xml\n\nEnd-to-end Android XML localization with CLI and GitHub Actions
Emails\n\nTranslate transactional and marketing email templates with brand voice applied
Static Content\n\nTranslate Markdown, JSON, and other static files in your repository
CI/CD Workflows\n\nAutomate localization on every push with GitHub Actions, GitLab CI, or Bitbucket
Engine Setup with MCP\n\nConfigure a localization engine using AI coding assistants through the Lingo.dev MCP server
Jira Triage\n\nAutomatically triage Jira tickets for localization relevance with AI-powered suggestions