Usando o globalize.now com o Cursor

Extraia strings e gere arquivos de locale a partir de apps criados no Cursor com um único comando.

O Cursor gera interfaces funcionais rapidamente, mas normalmente grava o texto em inglês diretamente no JSX de forma fixa. O globalize.now extrai essas strings fixas, gera chaves de tradução e cria arquivos de locale — transformando um app criado no Cursor em uma base de código pronta para tradução. A configuração leva um único comando e, depois disso, sincroniza a cada push no Git.

Pré-requisitos

  • Um projeto criado com o Cursor
  • Um repositório Git
  • Node.js 18+
  • Qualquer biblioteca de i18n em JavaScript instalada (i18next, next-intl e similares), ou nenhuma, se você estiver começando do zero

Como configurar o globalize.now com o Cursor

  1. Abra seu projeto no Cursor e confirme o Git

    Abra o repositório no Cursor e garanta que sua base de código esteja commitada e enviada para um remoto Git, para que pushes futuros possam disparar a sincronização.

  2. Execute o instalador de skills na raiz do projeto

    Conecte o repositório no globalize.now para convertê-lo diretamente no app, ou instale as skills do agente Globalize em um terminal na raiz do repositório para que seu assistente possa estruturar o i18n e escanear a árvore de arquivos.

    npx skills add globalize-now/globalize-skills --all
  3. Deixe o agente analisar a base de código

    Siga os prompts do agente para que ele possa localizar strings fixas visíveis ao usuário em seus componentes e rotas.

  4. Revise a estrutura de chaves de tradução proposta

    Inspecione a estrutura e a nomenclatura de chaves sugeridas antes que qualquer refatoração seja aplicada à sua branch.

  5. Confirme a extração e os arquivos de locale

    Aprove as alterações para que as chaves sejam geradas, os componentes passem a chamar sua API de i18n em tempo de execução em vez de literais, e os arquivos de locale sejam gravados no repositório.

  6. Faça commit e push

    Faça commit das alterações e envie para sua branch padrão, para que o globalize.now possa manter as novas strings alinhadas nos próximos pushes do Git.

Conecte via MCP (opcional)

Prefere controlar o Globalize a partir do Cursor? Depois que seu código estiver pronto para i18n, conecte o MCP.

Adicione ao ~/.cursor/mcp.json

{"mcpServers":{"globalize":{"url":"https://api.globalize.now/mcp"}}}

Mais informações: conecte o MCP →

Problemas comuns

O Cursor continua adicionando novas strings fixas

Resolução: O globalize.now roda a cada push no Git, então novos literais são identificados automaticamente em vez de se acumularem silenciosamente entre lançamentos.

As chaves de tradução conflitam com uma configuração de i18n já existente

Resolução: O globalize.now detecta bibliotecas de i18n já existentes e segue suas convenções, para que as novas chaves ampliem seu catálogo atual em vez de entrar em conflito com ele.

Perguntas frequentes

O globalize.now funciona com qualquer projeto gerado pelo Cursor?

Sim, desde que a stack seja uma das que o globalize.now suporta por meio de suas skills de agente (frameworks JavaScript modernos, como Next.js, React ou Vue). O globalize.now se concentra em extrair strings de UI fixas e gerar chaves e arquivos de locale, e não em qual editor produziu o JSX. Você ainda executa npx skills add globalize-now/globalize-skills a partir da raiz do projeto e segue os prompts guiados para que o agente possa escanear o repositório e abrir diffs prontos para merge.

Preciso configurar o globalize.now para detectar padrões específicos do Cursor?

Não é necessária uma integração separada para o Cursor. O globalize.now analisa o repositório da mesma forma, independentemente de os arquivos terem sido escritos manualmente ou pelo Cursor. As skills procuram literais visíveis ao usuário e a estrutura de rotas, e então propõem chaves compatíveis com a biblioteca de i18n que você adotar. Você revisa o plano no Git como faria com qualquer outra mudança.

Posso usar o globalize.now em um projeto Cursor que já tem i18n parcial?

Sim. A ferramenta foi projetada para estender catálogos existentes quando já há chaves e arquivos de locale presentes. O globalize.now detecta a biblioteca de runtime que você usa e propõe adições em vez de descartar o trabalho anterior, permitindo concluir a migração dos literais de forma incremental. Continue usando pushes no Git para manter a cobertura de novas telas.

Com quais bibliotecas de i18n a saída do globalize.now funciona em um projeto Cursor?

O globalize.now é agnóstico em relação à biblioteca: ele gera chaves estruturadas e arquivos de locale compatíveis com runtimes comuns como i18next, next-intl, react-intl, Lingui e vue-i18n. Seu projeto Cursor mantém a stack que você escolher; o globalize.now fornece a camada de extração e sincronização. As skills do agente ajudam a configurar o provider ou middleware que seu framework espera.

O globalize.now altera os componentes gerados pelo Cursor?

O globalize.now reescreve os pontos de chamada para que os literais passem pela sua API de i18n (por exemplo, t() ou componentes de mensagem), preservando o comportamento original. Você revisa os diffs no Git antes de fazer merge, assim como faria com qualquer mudança gerada pelo Cursor. Após o primeiro merge, os próximos pushes continuam sincronizando novas strings automaticamente, sem uma etapa de exportação separada.

Onde executo o globalize.now dentro do Cursor?

Sempre execute npx skills add globalize-now/globalize-skills a partir da raiz do repositório no terminal integrado do Cursor (ou em qualquer shell apontado para essa raiz). As skills se limitam ao projeto atual, instalam o pacote de skills de localização e devolvem o controle ao seu agente para os prompts seguintes. Permanecer na raiz mantém a detecção de caminhos alinhada com a forma como a CLI varre a árvore de arquivos.

Experimente o globalize.now com o Cursor

Comece pela raiz do seu projeto:

npx skills add globalize-now/globalize-skills --all

Volte para a página inicial para conhecer o produto e os preços →

Outras integrações

Comece grátis