Por que você deve considerar o Intlayer?

O que é o Intlayer?

Intlayer é uma biblioteca de internacionalização projetada especificamente para desenvolvedores JavaScript. Ela permite a declaração de seu conteúdo em qualquer parte do seu código. Converte declarações de conteúdo multilíngue em dicionários estruturados para integrar facilmente no seu código. Utilizando TypeScript, o Intlayer torna o seu desenvolvimento mais forte e mais eficiente.

Por que o Intlayer em vez de alternativas?

Comparado às soluções principais como next-intl ou i18next, o Intlayer é uma solução que vem com otimizações integradas, tais como:

Por que o Intlayer foi criado?

O Intlayer foi criado para resolver um problema comum que afeta todas as bibliotecas de i18n habituais como next-intl, react-i18next, react-intl, next-i18next, react-intl e vue-i18n.

Todas essas soluções adotam uma abordagem centralizada para listar e gerenciar seus conteúdos. Por exemplo:

.
├── locales
│   ├── en.json
│   ├── es.json
│   └── fr.json
├── i18n.ts
└── src
    └── components
        └── MyComponent
            └── index.tsx

Ou aqui utilizando namespaces:

.
├── locales
│   ├── en
│   │  ├── footer.json
│   │  └── navbar.json
│   ├── fr
│   │  ├── footer.json
│   │  └── navbar.json
│   └── es
│      ├── footer.json
│      └── navbar.json
├── i18n.ts
└── src
    └── components
        └── MyComponent
            └── index.tsx

Esse tipo de arquitetura torna o processo de desenvolvimento mais lento e a base de código mais complexa de manter por vários motivos:

1. Para qualquer novo componente criado, você deve:

   • Criar o novo recurso/namespace na pasta locales
   • Lembrar de importar o novo namespace na sua página
   • Traduzir seu conteúdo (frequentemente feito de forma manual por cópia/cola de provedores de IA)

2. Para qualquer mudança feita em seus componentes, você deve:

   • Procurar o recurso/namespace correspondente (longe do componente)
   • Traduzir seu conteúdo
   • Garantir que seu conteúdo esteja atualizado para todos os idiomas
   • Verificar se o seu namespace não inclui chaves/valores não utilizados
   • Garantir que a estrutura dos seus arquivos JSON seja a mesma para todos os idiomas

Em projetos profissionais que utilizam essas soluções, plataformas de localização são frequentemente utilizadas para ajudar a gerenciar a tradução de conteúdo. No entanto, isso pode rapidamente se tornar caro para projetos grandes.

Para resolver esse problema, o Intlayer adota uma abordagem que delimita seu conteúdo por componente e mantém o conteúdo próximo ao componente, como costumamos fazer com CSS (styled-components), tipos, documentação (storybook) ou testes unitários (jest).

.
└── components
    └── MyComponent
        ├── index.content.ts
        ├── index.test.tsx
        ├── index.stories.tsx
        └── index.tsx

import { t, type Dictionary } from "intlayer";

const componentExampleContent = {
  key: "component-example",
  content: {
    myTranslatedContent: t({
      en: "Hello World",
      es: "Hola Mundo",
      fr: "Bonjour le monde",
    }),
  },
} satisfies Dictionary;

export default componentExampleContent;

import { useIntlayer } from "react-intlayer";

export const ComponentExample = () => {
  const { myTranslatedContent } = useIntlayer("component-example");

  return <span>{myTranslatedContent}</span>;
};

Esta abordagem permite-lhe:

1. Aumentar a velocidade de desenvolvimento

   • Os arquivos .content.{ts|js|mjs|cjs|json|tsx|jsx|md|mdx|yaml|yml} podem ser criados utilizando uma extensão do VSCode
   • Ferramentas de autocompletar de IA no seu IDE (como GitHub Copilot) podem ajudá-lo a declarar seus conteúdos, reduzindo cópias/colas

2. Limpar a sua base de código

   • Reduzir a complexidade
   • Aumentar a manutenibilidade

3. Duplicar os seus componentes e seus conteúdos correspondentes com mais facilidade (Exemplo: componentes de login/registro, etc.)

   • Limitando o risco de impactar o conteúdo de outros componentes
   • Copiando e colando seus conteúdos de uma aplicação para outra sem dependências externas

4. Evitar poluir a sua base de código com chaves/valores não utilizados para componentes não utilizados

   • Se você não usar um componente, o Intlayer não importará o conteúdo relacionado
   • Se excluir um componente, lembrará mais facilmente de remover o conteúdo relacionado, pois ele estará presente na mesma pasta

5. Reduzir o custo de raciocínio para os agentes de IA ao declararem os seus conteúdos multilíngues

   • O agente de IA não terá que escanear toda a sua base de código para saber onde implementar seu conteúdo
   • As traduções podem ser facilmente feitas por ferramentas de autocompletar de IA no seu IDE (como GitHub Copilot)

6. Otimizar o desempenho de carregamento

   • Se um componente for carregado de forma diferida (lazy-loaded), seu conteúdo relacionado será carregado ao mesmo tempo

Recursos adicionais do Intlayer

Mostrar todo o conteúdo da tabela

Mostrar todo o conteúdo da tabela

Abrir a tabela em um modal para ver todo o conteúdo claramente

Recurso	Descrição
	Suporte Cross-Framework O Intlayer é compatível com todos os principais frameworks e bibliotecas, incluindo Next.js, React, Vite, Vue.js, Nuxt, Preact, Express e mais.
	Gerenciamento de Conteúdo via JavaScript Aproveite a flexibilidade do JavaScript para definir e gerenciar seu conteúdo de forma eficiente. - Declaração de conteúdo
	Compilador O Compilador Intlayer extrai automaticamente o conteúdo dos componentes e gera os arquivos de dicionário. - Compilador
	Arquivo de Declaração de Conteúdo por Idioma Acelere o seu desenvolvimento declarando o seu conteúdo uma única vez, antes da geração automática. - Arquivo de Declaração de Conteúdo por Idioma
	Ambiente Seguro para Tipos (Type-Safe) Aproveite o TypeScript para garantir que suas definições de conteúdo e código estejam livres de erros, enquanto se beneficia do preenchimento automático do IDE. - Configuração do TypeScript
	Configuração Simplificada Comece a funcionar rapidamente com uma configuração mínima. Ajuste as configurações de internacionalização, roteamento, IA, compilação e manuseio de conteúdo de maneira fácil. - Explorar integração com Next.js
	Recuperação de Conteúdo Simplificada Não há necessidade de chamar sua função t para cada elemento de conteúdo. Recupere todo o seu conteúdo diretamente usando um único hook. - Integração com React
	Implementação Consistente de Componentes de Servidor Perfeitamente adequado para componentes de servidor Next.js, use a mesma implementação tanto para componentes cliente quanto servidor, sem a necessidade de passar sua função t através de cada componente de servidor. - Componentes de Servidor
	Base de Código Organizada Mantenha sua base de código mais organizada: 1 componente = 1 dicionário na mesma pasta. Traduções próximas a seus respectivos componentes melhoram a manutenibilidade e a clareza. - Como o Intlayer funciona
	Roteamento Aprimorado Suporte completo de roteamento de apps, adaptando-se perfeitamente a estruturas de aplicações complexas, para Next.js, React, Vite, Vue.js, etc. - Explorar integração com Next.js
	Suporte a Markdown Importe e interprete arquivos locais e Markdown remoto para conteúdos multilíngues como políticas de privacidade, documentação, etc. Interprete e torne os metadados de Markdown acessíveis em seu código. - Arquivos de conteúdo
	Editor Visual & CMS Gratuitos Um editor visual e CMS gratuitos estão disponíveis para criadores de conteúdo, eliminando a necessidade de uma plataforma de localização externa. Mantenha seu conteúdo sincronizado usando o Git, ou externalize-o total ou parcialmente com o CMS. - Editor do Intlayer - CMS do Intlayer
	Conteúdo com Otimização Tree-shaking Conteúdo compatível com otimização tree-shaking, reduzindo o tamanho do pacote final. Carrega conteúdo por componente, excluindo do bundle os conteúdos não utilizados. Suporta carregamento lento (lazy loading) para melhorar a eficiência de carregamento do app. - Otimização do build de aplicação
	Renderização Estática Não bloqueia o Renderização Estática. - Integração com Next.js
	Tradução Inteligente baseada em IA Transforme o seu site para até 231 idiomas com apenas um clique usando as ferramentas avançadas de tradução por IA do Intlayer com o seu próprio provedor de IA/chave de API. - Integração com CI/CD - Intlayer CLI - Preenchimento Automático
	Integração do Servidor MCP Fornece um servidor MCP (Model Context Protocol) para automação de IDE, permitindo gerenciamento integrado de conteúdo e fluxos de trabalho i18n diretamente no seu ambiente de desenvolvimento. - Servidor MCP
	Extensão VSCode O Intlayer fornece uma extensão do VSCode para ajudá-lo a gerenciar seu conteúdo e traduções, construir dicionários, traduzir conteúdos e muito mais. - Extensão VSCode
	Interoperabilidade Permite a interoperabilidade com react-i18next, next-i18next, next-intl e react-intl. - Intlayer e react-intl - Intlayer e next-intl - Intlayer e next-i18next - Adaptadores de compatibilidade do Intlayer
Testar Traduções Ausentes (CLI/CI)	✅ CLI: npx intlayer content test (auditoria compatível com CI)

Comparação do Intlayer com outras soluções

Estrelas no GitHub

As estrelas no GitHub são um forte indicador da popularidade de um projeto, da confiança da comunidade e da relevância a longo prazo. Embora não sejam uma medida direta da qualidade técnica, refletem quantos desenvolvedores consideram o projeto útil, acompanham seu progresso e provavelmente o adotarão. Para estimar o valor de um projeto, as estrelas ajudam a comparar a tração entre alternativas e fornecem insights sobre o crescimento do ecossistema.

Interoperabilidade

intlayer também pode ajudar a gerenciar seus namespaces para react-intl, react-i18next, next-intl, next-i18next e vue-i18n.

Utilizando intlayer, você pode declarar seu conteúdo no formato de sua biblioteca i18n favorita, e o intlayer gerará seus namespaces no local de sua escolha (exemplo: /messages/{{locale}}/{{namespace}}.json).

Se você quiser continuar usando a API da sua biblioteca i18n atual, o intlayer também fornece adaptadores de compatibilidade (compat adapters): pacotes que expõem exatamente a mesma API que react-i18next, next-intl, react-intl, vue-i18n e outras, mas servidos pelos dicionários do Intlayer. Isso permite migrar progressivamente sem reescrever seu código. Consulte a documentação dos adaptadores de compatibilidade.

Perguntas Frequentes