A CLI do Lingo.dev traduz os arquivos de recursos do seu app web — JSON, YAML, XLIFF, PO ou PHP — com um engine de localização configurado. Configure o i18n no seu framework, aponte a CLI para os arquivos de tradução e execute.
Como funciona#
Todo framework web tem uma biblioteca de i18n que carrega traduções de arquivos de recursos — JSON para React, XLIFF para Angular, PO para Django e assim por diante. A CLI traduz esses arquivos diretamente, para que o framework use as traduções sem exigir nenhuma alteração no código.
Configure o i18n no seu framework
Use a biblioteca oficial de i18n do seu framework para adicionar roteamento por idioma, uma função de tradução e arquivos de recursos no idioma de origem. Cada seção de framework abaixo traz um link para o guia oficial de configuração.
Configure a CLI
Crie um arquivo i18n.json informando à CLI onde estão os arquivos de tradução e quais idiomas devem ser alvo. O tipo de bucket corresponde ao formato de recursos do seu framework.
Execute as traduções
Execute npx lingo.dev@latest run e a CLI traduzirá seus arquivos de recursos com o engine de localização — regras de glossário, voz da marca e seleção de modelo são aplicadas automaticamente.
Pré-requisitos#
Cada execução da CLI envia o conteúdo por um engine de localização — a configuração que determina qual modelo de LLM, glossário, voz da marca e instruções serão aplicados. Crie um no dashboard do Lingo.dev e gere uma chave de API.
Configuração com IA
O i18n MCP pode montar automaticamente toda a infraestrutura de i18n do seu framework. Conecte-o ao Claude Code, Cursor ou GitHub Copilot e use o prompt "Set up i18n" — o agente segue uma checklist de 13 etapas para configurar roteamento, arquivos de tradução e um seletor de idioma.
Frameworks JavaScript#
O react-i18next carrega traduções de arquivos JSON e fornece um hook useTranslation que mapeia chaves para strings traduzidas em tempo de execução.
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de", "ja"]
},
"buckets": {
"json": {
"include": ["public/locales/[locale]/translation.json"]
}
}
}Frameworks server-side#
O Laravel vem com localização nativa, que carrega traduções de arquivos PHP organizados por diretório de idioma.
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de", "ja"]
},
"buckets": {
"php": {
"include": ["lang/[locale]/messages.php"]
}
}
}Executando traduções#
Com i18n.json configurado, traduza todos os arquivos de recursos com um único comando:
npx lingo.dev@latest runA CLI lê os arquivos no idioma de origem, calcula o que mudou desde a última execução usando o lockfile, traduz apenas o delta e grava os resultados nos arquivos dos idiomas de destino. As traduções existentes são preservadas — a CLI só preenche strings ausentes ou atualizadas.
Direcione para um idioma ou bucket específico ao trabalhar em apenas uma parte do conteúdo:
npx lingo.dev@latest run --target-locale es
npx lingo.dev@latest run --bucket json