# Localization Guides

Max Prilutskiy·Updated 2 months 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](/content/en/guides#how-guides-work/index.html)

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](/content/en/guides/translation-api/index.html) | Key-value data, dynamic content | HTTP API calls |
| [Web apps](/content/en/guides/web-app/index.html) | UI strings, component text | CLI + framework integration |
| [Mobile apps](/content/en/guides/mobile-app/index.html) | iOS `.strings`, Android `.xml` | CLI + mobile build pipeline |
| [iOS apps](/content/en/guides/ios-app-localization/index.html) | Xcode String Catalogs `.xcstrings` | CLI + GitHub Actions |
| [Android apps](/content/en/guides/android-app-localization/index.html) | Android `strings.xml` | CLI + GitHub Actions |
| [Next.js with Markdoc](/content/en/guides/markdoc-nextjs-localization/index.html) | Markdoc pages and JSON UI strings | CLI + GitHub Actions |
| [Rails with i18n](/content/en/guides/ruby-on-rails-localization/index.html) | Rails `config/locales` YAML | CLI + GitHub Actions |
| [Emails](/content/en/guides/emails/index.html) | Transactional and marketing templates | API or CLI depending on template format |
| [Static content](/content/en/guides/static-content/index.html) | Markdown, JSON, YAML files | CLI with file-based translation |
| [CI/CD workflows](/content/en/guides/ci-cd-workflows/index.html) | All of the above, automated | GitHub Actions, GitLab CI, Bitbucket Pipelines |

### Prerequisites

All guides require an [API key](/content/en/docs/platform/api-keys/index.html) and a configured [localization engine](/content/en/docs/platform/engines/index.html). If you haven't set these up yet, start with the [documentation](/content/en/docs/platform/index.html).

## [Choose Your Guide](/content/en/guides#choose-your-guide/index.html)

[Translation API \ Send key-value data to the localization API and get translations back programmatically](/content/en/guides/translation-api/index.html)  
[Web App \ Localize React, Next.js, and other web frameworks using the CLI](/content/en/guides/web-app/index.html)  
[Mobile App \ Localize iOS and Android applications with per-locale model selection](/content/en/guides/mobile-app/index.html)  
[iOS with String Catalogs \ End-to-end Xcode .xcstrings localization with CLI and GitHub Actions](/content/en/guides/ios-app-localization/index.html)  
[Android with strings.xml \ End-to-end Android XML localization with CLI and GitHub Actions](/content/en/guides/android-app-localization/index.html)  
[Rails with i18n \ End-to-end Rails config/locales YAML localization with CLI and GitHub Actions](/content/en/guides/ruby-on-rails-localization/index.html)  
[Emails \ Translate transactional and marketing email templates with brand voice applied](/content/en/guides/emails/index.html)  
[Static Content \ Translate Markdown, JSON, and other static files in your repository](/content/en/guides/static-content/index.html)  
[CI/CD Workflows \ Automate localization on every push with GitHub Actions, GitLab CI, or Bitbucket](/content/en/guides/ci-cd-workflows/index.html)  
[Engine Setup with MCP \ Configure a localization engine using AI coding assistants through the Lingo.dev MCP server](/content/en/guides/mcp-engine-setup/index.html)  
[Jira Triage \ Automatically triage Jira tickets for localization relevance with AI-powered suggestions](/content/en/guides/triage/index.html)