Se o seu repositório já tem next-intl, react-i18next, i18next ou Lingui configurados (pastas de locale no disco, dependências em package.json, middleware ou arquivos de configuração), você não precisa de mais uma ferramenta que age como se você estivesse começando do zero. A globalize.now é uma infraestrutura de localização com IA. No modo L1 (já internacionalizado), o produto pula o scaffold destrutivo de configuração e fica no modo de sincronização: lê o seu idioma de origem, compara os outros locales a cada push e abre pull requests com as lacunas preenchidas. Este artigo mostra o que esse modo toca, o que ele se recusa a tocar e o que fazer quando a detecção erra.
Por que a maioria das dicas sobre i18n parte do princípio de que você está começando do zero?
Os materiais de marketing de ferramentas de i18n ainda se baseiam no cenário "greenfield": nenhuma biblioteca instalada, nenhum arquivo de locale, nenhuma extração feita. A maioria dos códigos em produção não está nessa situação.
Nas últimas semanas, três sessões de primeiro contato sem nenhuma relação entre si chegaram com o mesmo perfil: a equipe tentou fazer i18n uma vez, deixou algo meio funcionando e parou, porque arrancar tudo e refazer parecia pior do que conviver com a bagunça.
Se esse é o seu caso, este post foi escrito para você.
Como é, na prática, uma base de código parcialmente internacionalizada?
Esses padrões aparecem repetidamente (detalhes anonimizados):
- Um app Next.js + next-intl em que a maioria dos componentes usa
t(), mas rotas mais antigas ainda enviam texto fixo em inglês porque a primeira leva de migração nunca foi concluída. - Um projeto React + i18next cujos arquivos de locale existem, mas só contêm valores em inglês: traduzir sempre ficou para o próximo trimestre.
- Uma árvore
messages/em queen.jsonestá completo ees.jsonestá praticamente vazio. - Um seletor de idioma incorporado ao layout que às vezes retorna 404 porque o roteamento foi migrado apenas pela metade.
Nenhum desses projetos precisa que o globalize.now recomece do zero. Eles precisam que ele conclua o trabalho.
Quais sinais o globalize.now busca na primeira execução?
A detecção acontece em duas etapas, não em uma só.
Primeiro, aponte a globalize.now para o repositório. Conectar o repositório no app já executa a detecção e a conversão única para você. Se preferir que o seu agente faça essa passada localmente, instale as skills. Isso coloca alguns arquivos de playbook em .claude/skills/ e não altera mais nada no seu repositório:
npx skills add globalize-now/globalize-skills
Depois, dê o prompt ao seu agente: Claude Code, Cursor ou Codex. O agente lê as skills instaladas e as usa para varrer o seu repositório:
Set up localization for my project
É nessa segunda etapa que a detecção de fato acontece. O agente procura por:
- Dependências de
package.json:next-intl,react-i18next,i18next,@lingui/core,@lingui/react,@lingui/macro, ou qualquer plugin dei18next-*. - Pastas de locale:
messages/na raiz do repositório, uma pastalocales/, ousrc/i18n/com subpastas de locale. - Arquivos de locale existentes:
en.json,en.po,en.yml,en.yaml, ou o arquivo do locale padrão que sua biblioteca já espera. - Configuração específica de framework:
i18n.config.ts, middleware do next-intl,lingui.config.js, ou equivalentes.
Se pelo menos dois desses sinais estiverem presentes, o projeto é tratado como L1 (já internacionalizado) e o fluxo de configuração desvia, em vez de rodar o scaffold completo para projetos novos. Mais detalhes estão no artigo da Central de Ajuda sobre i18n existente.
O que o modo L1 se recusa a alterar?
Esta é a parte com que as pessoas se importam. No modo L1, o globalize.now não:
- Executa a varredura ampla de extração de strings que vasculha componentes em busca de literais fixos.
- Gera novas chaves de tradução ou reorganiza a estrutura de chaves que você já definiu.
- Cria do zero arquivos de locale para idiomas que você ainda não configurou.
- Injeta um seletor de idioma. Se você já tem um, ele permanece. Se não tem, nós não adicionamos um.
- Reescreve roteamento, middleware ou configuração de framework por você.
Sua configuração de i18n existente continua sendo sua. Nesse modo, não a reestruturamos.
O que o modo de sincronização L1 faz depois da detecção?
O L1 prioriza a sincronização. Depois que a detecção se estabiliza:
- Lemos seus arquivos de locale existentes para entender a estrutura atual das chaves e qual idioma é a fonte de verdade.
- Você conecta o repositório do GitHub pela CLI do globalize.now ou pelo aplicativo web.
- A cada push para sua branch main, comparamos o arquivo do idioma de origem com os demais locales. As traduções ausentes são preenchidas com saída de IA que respeita o glossário e o guia de estilo que você configurou.
- Um pull request chega com os arquivos de locale atualizados. Você revisa e faz o merge. Nós nunca mesclamos por você.
Esse é o ciclo. Sem painel de tradução para vigiar. Sem exportações manuais. Sem malabarismo de formatos de arquivo.
Compare com o passo a passo do L0 em Como adicionar i18n a um app Next.js feito no Cursor em 15 minutos?: mesmo produto, caminho de entrada diferente.
E se só parte da interface usar chamadas de tradução?
Esse é o padrão normal de migração parcial: telas novas usam t(), telas antigas ainda vazam literais. Fora do modo de sincronização, o pipeline de skills trata as strings que já têm chave como travadas: ele foca nos literais que ainda não foram conectados e preserva as chaves existentes. Times que fazem deploy toda semana enquanto estão no meio dessa migração são o usuário
Para um relato completo de conversão feita por agente em uma árvore complicada, veja O que acontece quando um agente de IA internacionaliza um monorepo real?.
O que fazer se o fluxo de configuração criou tudo do zero mesmo assim?
Estamos refinando a lógica de detecção para que o caminho errado não seja acionado, mas se o npx skills add globalize-now/globalize-skills já gerou um diff de mais de 100 arquivos que reescreve a sua pasta de locales, adiciona um seletor de idioma que você não pediu ou remodela o roteamento, não faça commit. Use o widget de feedback (canto inferior direito) com a lista de dependências do seu package.json e uma breve nota sobre como as suas pastas de locale estão organizadas; podemos encaminhar o repositório para o L1 manualmente. Uma flag de CLI --existing-i18n de autoatendimento chega em breve.
A recuperação na sua máquina é git restore . mais git clean -fd, se necessário. Nada foi enviado por push; nada em produção quebrou; o agente só mexeu na sua branch local. O relato completo está em O globalize_skills fez alterações demais: o que aconteceu?.
Por que "tentamos fazer i18n e travamos" virou a história padrão?
Isso não é slogan: é um padrão. Três sessões de primeiro contato independentes em seis semanas, três versões de "é, a gente tentou isso; ficou uma gambiarra." Uma extensão do Chrome com dezenas de milhares de usuários teve um pico de tráfego coreano e disparou uma migração de next-intl pela metade. Um app feito no Lovable quebrou o próprio build ao adicionar suporte multilíngue e foi revertido. Um repositório React + Vite criado com vibe coding configurou o i18next, preencheu cerca de um terço das chaves e parou.
A base de código L0 perfeitamente limpa, em busca de uma biblioteca, realmente existe, mas não é o gargalo. O gargalo é a base de código que já tentou isso uma vez e agora ninguém quer assumir a bagunça resultante.
O modo L1 existe exatamente para essa base de código.
Quanto custa?
O Starter custa € 20 por mês e inclui € 20 de crédito mensal, que é debitado por traduções, revisões de QA e conversões; o crédito não usado ao fim do período expira. Há também um plano Team a € 249 por mês com € 100 de crédito incluído. Novas organizações recebem um crédito de teste único de € 5 que expira após 14 dias. Seja você L0 e projeto novo ou L1 arrastando três anos de dívida de locales, o preço é o mesmo: o uso é cobrado pelo custo do provedor, não pela bagunça do primeiro commit.
Quais posts e documentos da Central de Ajuda devo ler em seguida?
- Passo a passo de configuração L0 para um app Next.js do Cursor
- Estudo de caso em monorepo: o que um agente realmente alterou
- Por que as ferramentas clássicas de TMS têm dificuldade com stacks modernas nativas de Git
- Central de Ajuda: eu já tenho i18n, o que a globalize.now faz?
- Central de Ajuda: globalize_skills fez mudanças demais
Entregue os idiomas que o seu tráfego já espera. Conecte o repositório em globalize.now ou veja como a automação por Git push se encaixa no fluxo de trabalho de um time que já existe.
O globalize.now transforma textos fixos do app em arquivos de locale prontos para tradução e os mantém atualizados a cada novo lançamento.
Experimente o globalize.now grátis