Perguntas Frequentes

    Usar o Intlayer no Next.js sem [locale] no caminho

    Aprenda como usar o Intlayer com Next.js sem `[locale]` no caminho da página.

    Posso usar um array como declaração de conteúdo?

    Sim: um array pode ser uma declaração de conteúdo no Intlayer. Como declará-lo, traduzir cada item e lê-lo nos seus componentes.

    Como construir dicionários?

    Quando o Intlayer constrói os dicionários automaticamente, como disparar um build manual com a CLI e onde os arquivos gerados são gravados.

    Corrigir erros de build do Intlayer em CI/CD

    Corrija erros de renderização de Server Components que só ocorrem em CI/CD, garantindo que os dicionários do Intlayer sejam construídos durante o build.

    Recebo erro de módulo não encontrado ao usar bun

    Corrija o erro «Cannot find package» ao usar o Intlayer com Bun, causado pela forma como o Bun limita o require(), com a configuração que resolve.

    Limitar o uso de tokens do Claude Code ao traduzir

    Por que traduzir com o Claude Code consome muitos tokens, o que o Intlayer faz no lugar e como reutilizar sua assinatura do Claude para traduções.

    Como personalizar a lista de idiomas?

    Personalize a lista de locales suportados pelo Intlayer no intlayer.config.ts, incluindo variantes regionais e o locale padrão.

    Como configurar roteamento baseado em domínio?

    Sirva cada locale no seu próprio domínio com o roteamento por domínio do Intlayer, configurado no intlayer.config.ts com os redirecionamentos incluídos.

    vite-env-only: falso erro de node:fs com o Intlayer

    Por que o vite-env-only reporta uma importação `node:fs` negada com Intlayer + React-Router + Vite e o que fazer.

    Corrigir erros do ESBuild com o Intlayer

    Corrija erros do ESBuild durante um build do Intlayer, geralmente causados por um plugin de bundler ausente ou mal configurado para o seu framework.

    Como recuperar a localidade dos cookies / cabeçalhos?

    Leia o locale atual dos cookies ou dos cabeçalhos da requisição com o Intlayer, no servidor ou em um middleware, para exibir o idioma certo.

    Tipo IntlayerNode. O que é?

    O que é o tipo IntlayerNode? Por que minha string é transformada em um IntlayerNode<string>?

    Comando Intlayer indefinido

    Corrija o erro «intlayer: command not found»: instale a CLI, execute-a pelo seu gerenciador de pacotes e verifique o PATH.

    Locale Incorreto Recuperado da URL

    Corrija um locale errado lido da URL no Next.js, como «about» em vez de «en», usando a estrutura de pastas [locale] que o Intlayer espera.

    É possível compor tipos de nós? (ex.: múltiplos plurais em uma mesma frase)

    Como compor tipos de nós e expressar múltiplas variáveis de plural independentes em uma única frase usando insert() ou plural() aninhado no Intlayer.

    Recebo um erro relacionado aos sub-pacotes @intlayer/*

    Corrija erros causados por versões diferentes dos subpacotes @intlayer/*: alinhe todos os pacotes do Intlayer na mesma versão e limpe o cache.

    Renderização Estática vs Dinâmica com i18n no Next.js

    Por que os helpers do next-intl deixam dinâmicas as rotas i18n do Next.js e como manter suas páginas localizadas com renderização estática.

    Posso traduzir o caminho do URL?

    Sim: o Intlayer pode traduzir caminhos de URL, como /about para /pt/sobre, com reescritas de URL configuradas por locale.

    Corrigir o erro «unknown command» do Intlayer

    Corrija o erro «unknown command» da CLI do Intlayer: verifique o nome do comando, a versão da CLI e como você chama o binário.

    Posso usar o Intlayer sem um provider global?

    Ler o conteúdo do Intlayer sem montar um provider, como o locale é resolvido no servidor e no navegador, e a diferença de performance em relação a um provider.