---
createdAt: 2025-02-07
updatedAt: 2025-06-29
title: Documentação Intlayer - Guia Completo de i18n para JavaScript
description: Documentação completa para Intlayer, a biblioteca moderna de internacionalização para JavaScript, React, Next.js, Express e mais frameworks.
keywords:
  - intlayer
  - internacionalização
  - i18n
  - JavaScript
  - React
  - Next.js
  - documentação
  - tradução
  - multilíngue
slugs:
  - doc
  - index
history:
  - version: 5.5.10
    date: 2025-06-29
    changes: "Histórico inicial"
---

# Documentação Intlayer

Bem-vindo à documentação oficial do **Intlayer**! Aqui, você encontrará tudo o que precisa para integrar, configurar e dominar o Intlayer para todas as suas necessidades de internacionalização (i18n), seja você um desenvolvedor trabalhando com **Next.js**, **React**, **Vite**, **Express** ou outro ambiente JavaScript.

O Intlayer oferece uma abordagem flexível e moderna para traduzir sua aplicação. Nossa documentação irá guiá-lo desde a instalação e configuração até recursos avançados como **tradução com inteligência artificial**, definições em **TypeScript** e suporte a **componentes de servidor**, capacitando você a criar uma experiência multilíngue fluida e integrada.

---

## Começando

- **[Introdução](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/introduction.md)**  
  Obtenha uma visão geral de como o Intlayer funciona, seus recursos principais e por que ele é um divisor de águas para i18n.

- **[Como o Intlayer Funciona](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/how_works_intlayer.md)**  
  Mergulhe no design arquitetônico e aprenda como o Intlayer gerencia tudo, desde a declaração de conteúdo até a entrega da tradução.

- **[Configuração](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md)**  
  Personalize o Intlayer para atender às necessidades do seu projeto. Explore opções de middleware, estruturas de diretórios e configurações avançadas.

- **[Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/index.md)**

Gerencie conteúdo e traduções usando nossa ferramenta de linha de comando. Descubra como enviar e puxar conteúdo, automatizar traduções e muito mais.

- **[Editor Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md)**  
  Simplifique a colaboração com não desenvolvedores e potencialize suas traduções com IA, diretamente em nosso CMS gratuito e intuitivo.

---

## Conceitos Principais

### Dicionário

Organize seu conteúdo multilíngue próximo ao seu código para manter tudo consistente e fácil de manter.

- **[Começando](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/content_file.md)**  
  Aprenda o básico de como declarar seu conteúdo no Intlayer.

- **[Tradução](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/translation.md)**

Entenda como as traduções são geradas, armazenadas e utilizadas em sua aplicação.

- **[Enumeração](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/enumeration.md)**  
  Gerencie facilmente conjuntos repetidos ou fixos de dados em vários idiomas.

- **[Condição](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/condition.md)**  
  Aprenda a usar lógica condicional no Intlayer para criar conteúdo dinâmico.

- **[Inserção](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/insertion.md)**  
  Descubra como inserir valores em uma string usando espaços reservados para inserção.

- **[Busca por Função](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/function_fetching.md)**

Veja como buscar conteúdo dinamicamente com lógica personalizada para corresponder ao fluxo de trabalho do seu projeto.

- **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/markdown.md)**  
  Aprenda a usar Markdown no Intlayer para criar conteúdo rico.

- **[Incorporação de arquivos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/file.md)**  
  Descubra como incorporar arquivos externos no Intlayer para usá-los no editor de conteúdo.

- **[Aninhamento](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/nesting.md)**  
  Entenda como aninhar conteúdo no Intlayer para criar estruturas complexas.

---

## Ambientes & Integrações

Construímos o Intlayer com flexibilidade em mente, oferecendo integração perfeita com frameworks populares e ferramentas de build:

- **[Intlayer com Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_nextjs_15.md)**
- **[Intlayer com Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_nextjs_14.md)**
- **[Intlayer com Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_nextjs_page_router.md)**
- **[Intlayer com React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_create_react_app.md)**
- **[Intlayer com Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_vite+react.md)**
- **[Intlayer com React Native e Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_react_native+expo.md)**
- **[Intlayer com Lynx e React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_lynx+react.md)**
- **[Intlayer com Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_express.md)**

Cada guia de integração inclui as melhores práticas para usar os recursos do Intlayer, como **renderização do lado servidor**, **roteamento dinâmico** ou **renderização do lado cliente**, para que você possa manter uma aplicação rápida, otimizada para SEO e altamente escalável.

---

## Pacotes

O design modular do Intlayer oferece pacotes dedicados para ambientes e necessidades específicas:

### `intlayer`

Funções utilitárias principais para configurar e gerenciar sua configuração i18n.

- **[getConfiguration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getConfiguration.md)**
- **[getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getHTMLTextDir.md)**
- **[getLocaleLang](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getLocaleLang.md)**
- **[getLocaleName](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getLocaleName.md)**
- **[getLocalizedUrl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getLocalizedUrl.md)**
- **[getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getMultilingualUrls.md)**
- **[getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getPathWithoutLocale.md)**
- **[getTranslation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getTranslation.md)**
- **[getEnumeration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getEnumeration.md)**

### `express-intlayer`

Aproveite o Intlayer em aplicativos baseados em **Express**:

- **[t](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/express-intlayer/t.md)**  
  Um auxiliar de tradução minimalista e direto para suas rotas e visualizações do servidor.

### `react-intlayer`

Melhore suas aplicações **React** com hooks poderosos:

- **[t](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/react-intlayer/t.md)**
- **[useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/react-intlayer/useIntlayer.md)**
- **[useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/react-intlayer/useDictionary.md)**
- **[useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/react-intlayer/useLocale.md)**

### `next-intlayer`

Integre perfeitamente com **Next.js**:

- **[t](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/next-intlayer/t.md)**
- **[useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/next-intlayer/useIntlayer.md)**
- **[useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/next-intlayer/useDictionary.md)**
- **[useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/next-intlayer/useLocale.md)**

---

## Recursos Adicionais

- **[Blog: Intlayer e i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_i18next.md)**  
  Saiba como o Intlayer complementa e se compara com a popular biblioteca **i18next**.

- **[Tutorial ao Vivo no YouTube](https://youtu.be/W2G7KxuSD4c?si=GyU_KpVhr61razRw)**  
  Assista a uma demonstração completa e aprenda como integrar o Intlayer em tempo real.

---

## Contribuindo e Feedback

Valorizamos o poder do desenvolvimento open-source e orientado pela comunidade. Se você deseja propor melhorias, adicionar um novo guia ou corrigir qualquer problema em nossa documentação, sinta-se à vontade para enviar um Pull Request ou abrir uma issue em nosso [repositório GitHub](https://github.com/aymericzip/intlayer/blob/main/docs/docs).

**Pronto para traduzir sua aplicação de forma mais rápida e eficiente?** Mergulhe em nossa documentação para começar a usar o Intlayer hoje mesmo. Experimente uma abordagem robusta e simplificada para internacionalização que mantém seu conteúdo organizado e sua equipe mais produtiva.
