@intlayer/docs 5.5.10 → 5.5.12

package/docs/pt/introduction.md

@@ -0,0 +1,222 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-06-29
+title: Introdução
+description: Descubra como o Intlayer funciona. Veja os passos usados pelo Intlayer na sua aplicação. Veja o que os diferentes pacotes fazem.
+keywords:
+  - Introdução
+  - Começar
+  - Intlayer
+  - Aplicação
+  - Pacotes
+slugs:
+  - doc
+  - get-started
+---
+
+# Documentação do 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 usando Next.js, React, Vite, Express ou outro ambiente JavaScript.
+
+## Introdução
+
+### O que é o Intlayer?
+
+**Intlayer** é uma biblioteca de internacionalização projetada especificamente para desenvolvedores JavaScript. Ela permite a declaração do seu conteúdo em qualquer lugar do seu código. Converte declarações de conteúdo multilíngue em dicionários estruturados para integrar facilmente no seu código. Usando TypeScript, **Intlayer** torna seu desenvolvimento mais robusto e eficiente.
+
+O Intlayer também oferece um editor visual opcional que permite editar e gerenciar seu conteúdo facilmente. Esse editor é particularmente útil para desenvolvedores que preferem uma interface visual para gerenciamento de conteúdo, ou para equipes que geram conteúdo sem precisar se preocupar com código.
+
+### Exemplo de uso
+
+```bash
+.
+└── Components
+    └── MyComponent
+        ├── index.content.cjs
+        └── index.mjs
+```
+
+```tsx fileName="src/components/MyComponent/index.content.ts" contentDeclarationFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+} satisfies Dictionary;
+
+export default componentContent;
+```
+
+```javascript fileName="src/components/MyComponent/index.content.mjs" contentDeclarationFormat="esm"
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+// Conteúdo do componente com traduções multilíngues
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+};
+
+export default componentContent;
+```
+
+```javascript fileName="src/components/MyComponent/index.content.cjs" contentDeclarationFormat="commonjs"
+const { t } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+};
+
+module.exports = componentContent;
+```
+
+```json fileName="src/components/MyComponent/index.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "component-key",
+  "content": {
+    "myTranslatedContent": {
+      "nodeType": "translation",
+      "translation": {
+        "en": "Hello World",
+        "fr": "Bonjour le monde",
+        "es": "Hola Mundo"
+      }
+    }
+  }
+}
+```
+
+```tsx fileName="src/components/MyComponent/index.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+export const MyComponent: FC = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="src/components/MyComponent/index.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="src/components/MyComponent/index.csx" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+## Principais Funcionalidades
+
+Intlayer oferece uma variedade de funcionalidades adaptadas para atender às necessidades do desenvolvimento web moderno. Abaixo estão as principais funcionalidades, com links para documentação detalhada de cada uma:
+
+- **Suporte à Internacionalização**: Amplie o alcance global da sua aplicação com suporte integrado para internacionalização.
+- **Editor Visual**: Melhore seu fluxo de desenvolvimento com plugins de editor projetados para Intlayer. Confira o [Guia do Editor Visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md).
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+  };
+
+```
+
+## Principais Funcionalidades
+
+O Intlayer oferece uma variedade de funcionalidades adaptadas para atender às necessidades do desenvolvimento web moderno. Abaixo estão as principais funcionalidades, com links para documentação detalhada de cada uma:
+
+- **Suporte à Internacionalização**: Amplie o alcance global da sua aplicação com suporte integrado para internacionalização.
+- **Editor Visual**: Melhore seu fluxo de trabalho de desenvolvimento com plugins de editor projetados para o Intlayer. Confira o [Guia do Editor Visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md).
+- **Flexibilidade de Configuração**: Personalize sua configuração com opções extensas detalhadas no [Guia de Configuração](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md).
+- **Ferramentas Avançadas de CLI**: Gerencie seus projetos de forma eficiente usando a interface de linha de comando do Intlayer. Explore as capacidades na [Documentação das Ferramentas CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_cli.md).
+
+## 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/get_started.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 na sua aplicação.
+
+- **[Enumeração](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/enumeration.md)**
+  Gerencie facilmente conjuntos de dados repetidos ou fixos em vários idiomas.
+
+- **[Condição](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/conditional.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 adequar 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_embeddings.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 no lado do servidor**, **roteamento dinâmico** ou **renderização no lado do cliente**, para que você possa manter uma aplicação rápida, otimizada para SEO e altamente escalável.
+
+## Contribuindo & Feedback
+
+Valorizamos o poder do código aberto e do desenvolvimento orientado pela comunidade. Se desejar propor melhorias, adicionar um novo guia ou corrigir quaisquer problemas 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.
+
+---
+
+## Histórico da Documentação
+
+- 5.5.10 - 2025-06-29: Histórico inicial
+```

package/docs/pt/mcp_server.md

@@ -0,0 +1,174 @@
+---
+createdAt: 2025-06-07
+updatedAt: 2025-06-07
+title: Documentação do Servidor MCP
+description: Explore os recursos e a configuração do Servidor MCP para otimizar a gestão e operações do seu servidor.
+keywords:
+  - Servidor MCP
+  - Gestão de Servidor
+  - Otimização
+  - Intlayer
+  - Documentação
+  - Configuração
+  - Recursos
+slugs:
+  - doc
+  - mcp-server
+---
+
+# Servidor MCP Intlayer
+
+O **Servidor Intlayer MCP (Model Context Protocol)** oferece assistência para IDE com inteligência artificial, adaptada ao ecossistema Intlayer. Projetado para ambientes modernos de desenvolvimento como **Cursor**, **GitHub Copilot workspace** e qualquer IDE que suporte o protocolo MCP, este servidor fornece suporte contextual e em tempo real baseado na configuração do seu projeto.
+
+## Por que usar o Servidor Intlayer MCP?
+
+Ao ativar o Servidor Intlayer MCP na sua IDE, você desbloqueia:
+
+- **Integração Inteligente com CLI**
+  Acesse e execute comandos da CLI do Intlayer diretamente da interface da sua IDE. Veja a lista completa de comandos e opções na [documentação da CLI do Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_cli.md).
+
+- **Documentação Contextualizada**
+  O servidor MCP carrega e expõe a documentação que corresponde à versão do Intlayer que você está usando no seu projeto. Isso garante que as sugestões de código, opções de comando e explicações estejam sempre atualizadas e relevantes.
+
+- **Desenvolvimento Assistido por IA**
+  Com sugestões e autocompletar conscientes do projeto, o assistente de IA pode explicar seu código, recomendar o uso da CLI ou sugerir como usar recursos específicos do Intlayer com base nos seus arquivos atuais.
+
+- **Configuração Leve e Instantânea**
+  Nenhuma manutenção de servidor ou instalação pesada é necessária. Basta configurar seu arquivo `.cursor/mcp.json` ou configuração MCP equivalente e você estará pronto para começar.
+
+---
+
+## Configurar Cursor
+
+Na raiz do seu projeto, adicione o seguinte arquivo de configuração `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+Isso instrui seu IDE a iniciar o servidor MCP do Intlayer usando `npx`, garantindo que ele sempre use a versão mais recente disponível, a menos que você fixe uma versão específica.
+
+---
+
+## Configurar o VS Code
+
+Para usar o Servidor MCP do Intlayer com o VS Code, você precisa configurá-lo nas configurações do seu workspace ou usuário.
+
+### Configuração do Workspace
+
+Crie um arquivo `.vscode/mcp.json` na raiz do seu projeto:
+
+```json
+{
+  "servers": {
+    "intlayer": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+### Usando o Servidor MCP no VS Code
+
+1. **Ativar o Modo Agente**: Abra a visualização de Chat (⌃⌘I no Mac, Ctrl+Alt+I no Windows/Linux) e selecione o modo **Agente** no menu suspenso.
+
+2. **Acessar Ferramentas**: Clique no botão **Ferramentas** para visualizar as ferramentas Intlayer disponíveis. Você pode selecionar/deselecionar ferramentas específicas conforme necessário.
+
+3. **Referência Direta de Ferramentas**: Faça referência às ferramentas diretamente em seus prompts digitando `#` seguido do nome da ferramenta.
+
+4. **Confirmação de Ferramentas**: Por padrão, o VS Code solicitará confirmação antes de executar as ferramentas. Use as opções do botão **Continuar** para confirmar automaticamente as ferramentas para a sessão atual, workspace ou todas as invocações futuras.
+
+### Gerenciando o Servidor
+
+- Execute **MCP: Listar Servidores** no Command Palette para visualizar os servidores configurados
+- Inicie, pare ou reinicie o servidor MCP do Intlayer conforme necessário
+- Visualize os logs do servidor para solução de problemas selecionando o servidor e escolhendo **Mostrar Saída**
+
+Para obter informações mais detalhadas sobre a integração do VS Code MCP, consulte a [documentação oficial do VS Code MCP](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).
+
+---
+
+## Usando o Servidor MCP via CLI
+
+Você também pode executar o servidor Intlayer MCP diretamente a partir da linha de comando para testes, depuração ou integração com outras ferramentas.
+
+### Instalar o Servidor MCP
+
+Primeiro, instale o pacote do servidor MCP globalmente ou use-o via npx:
+
+```bash
+# Instalar globalmente
+npm install -g @intlayer/mcp
+
+# Ou usar diretamente com npx (recomendado)
+npx @intlayer/mcp
+```
+
+### Iniciar o Servidor
+
+Para iniciar o servidor MCP com o inspetor para depuração e testes:
+
+```bash
+# Usando o comando start embutido
+npm run start
+
+# Ou diretamente com npx
+npx @modelcontextprotocol/inspector npx @intlayer/mcp
+```
+
+Isso iniciará o servidor MCP com uma interface de inspetor que permite:
+
+- Testar comunicações do protocolo MCP
+- Depurar respostas do servidor
+- Validar implementações de ferramentas e recursos
+- Monitorar o desempenho do servidor
+
+### Uso em Desenvolvimento
+
+Para fins de desenvolvimento e teste, você pode executar o servidor em vários modos:
+
+```bash
+# Construir e iniciar em modo de desenvolvimento
+npm run dev
+
+# Executar com configuração personalizada
+node dist/cjs/index.cjs
+
+# Testar a funcionalidade do servidor
+npm test
+```
+
+O servidor exporá ferramentas e recursos específicos do Intlayer que podem ser consumidos por qualquer cliente compatível com MCP, não apenas pelo Cursor ou outros IDEs.
+
+---
+
+## Visão Geral das Funcionalidades
+
+| Feature                 | Description                                                                                    |
+| ----------------------- | ---------------------------------------------------------------------------------------------- |
+| Suporte CLI             | Execute comandos `intlayer`, obtenha dicas de uso e argumentos inline                          |
+| Documentação Versionada | Detecta automaticamente e carrega a documentação correspondente à sua versão atual do Intlayer |
+| Autocompletar           | Sugestões inteligentes de comandos e configurações enquanto você digita                        |
+| Pronto para Plugin      | Compatível com IDEs e ferramentas que suportam o padrão MCP                                    |
+
+---
+
+## Links Úteis
+
+- [Documentação CLI do Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_cli.md)
+- [Repositório GitHub do Intlayer](https://github.com/aymericzip/intlayer)
+
+---
+
+## Histórico da Documentação
+
+- 5.5.10 - 2025-06-29: Histórico inicial

package/docs/pt/packages/@intlayer/api/index.md

@@ -0,0 +1,56 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/api - SDK para Integração com a API do Intlayer
+description: Pacote NPM que fornece um Kit de Desenvolvimento de Software (SDK) para interagir com a API do Intlayer para auditoria de conteúdo, organizações, projetos e gerenciamento de usuários.
+keywords:
+  - intlayer
+  - API
+  - SDK
+  - integração
+  - auditoria de conteúdo
+  - organizações
+  - projetos
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - api
+---
+
+# @intlayer/api: Pacote NPM para interagir com a API do Intlayer
+
+**Intlayer** é um conjunto de pacotes projetados especificamente para desenvolvedores JavaScript. É compatível com frameworks como React, React e Express.js.
+
+**`@intlayer/api`** é um SDK (Kit de Desenvolvimento de Software) para interagir com a API do Intlayer. Ele fornece um conjunto de funções para auditar a declaração de conteúdo, interagir com organizações, projetos e usuários, etc.
+
+## Uso
+
+```ts
+import { intlayerAPI } from "@intlayer/api";
+
+intlayerAPI.user.getUser({
+  ids: ["user-id-1", "user-id-2"],
+});
+```
+
+## Instalação
+
+Instale o pacote necessário usando seu gerenciador de pacotes preferido:
+
+```bash packageManager="npm"
+npm install @intlayer/api
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/api
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/api
+```
+
+## Histórico da Documentação
+
+- 5.5.10 - 2025-06-29: Histórico inicial

package/docs/pt/packages/@intlayer/chokidar/index.md

@@ -0,0 +1,56 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/chokidar - Monitoramento de Arquivos para i18n do Intlayer
+description: Pacote NPM que fornece capacidades de monitoramento de arquivos para o Intlayer, permitindo atualizações automáticas e recarga a quente para conteúdo de internacionalização.
+keywords:
+  - intlayer
+  - chokidar
+  - monitoramento de arquivos
+  - recarga a quente
+  - i18n
+  - JavaScript
+  - NPM
+  - desenvolvimento
+slugs:
+  - doc
+  - package
+  - @intlayer_chokidar
+---
+
+# @intlayer/chokidar: Pacote NPM para Escanear e Construir Arquivos de Declaração do Intlayer em Dicionários
+
+**Intlayer** é um conjunto de pacotes projetados especificamente para desenvolvedores JavaScript. É compatível com frameworks como React, React e Express.js.
+
+O pacote **`@intlayer/chokidar`** é usado para escanear e construir arquivos de declaração do Intlayer em dicionários utilizando [chokidar](https://github.com/paulmillr/chokidar) e de acordo com a [configuração do Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md).
+
+## Uso
+
+```ts
+import { watch, prepareIntlayer } from "@intlayer/chokidar";
+
+await prepareIntlayer(); // Construir dicionários do Intlayer
+
+watch({ persistent: true }); // Monitorar alterações nos arquivos de configuração
+```
+
+## Instalação
+
+Instale o pacote necessário usando seu gerenciador de pacotes preferido:
+
+```bash packageManager="npm"
+bash packageManager="npm"
+npm install @intlayer/chokidar
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/chokidar
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/chokidar
+```
+
+## Histórico da Documentação
+
+- 5.5.10 - 2025-06-29: Histórico inicial

package/docs/pt/packages/@intlayer/cli/index.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/cli - Pacote de Interface de Linha de Comando para Intlayer
+description: Pacote NPM que fornece scripts para comandos da CLI do Intlayer, garantindo uniformidade em todas as interfaces de linha de comando para gerenciamento de internacionalização.
+keywords:
+  - intlayer
+  - CLI
+  - linha de comando
+  - scripts
+  - i18n
+  - JavaScript
+  - NPM
+  - ferramentas
+slugs:
+  - doc
+  - package
+  - @intlayer_cli
+---
+
+# @intlayer/cli: Pacote NPM para usar os scripts fornecidos pela CLI do intlayer
+
+**Intlayer** é um conjunto de pacotes projetados especificamente para desenvolvedores JavaScript. É compatível com frameworks como React, React e Express.js.
+
+O pacote **`@intlayer/cli`** é um pacote NPM usado para declarar os scripts relacionados às interfaces de linha de comando do intlayer. Ele garante a uniformidade de todos os comandos CLI do intlayer. Este pacote é notavelmente consumido pelos pacotes [intlayer-cli](https://github.com/aymericzip/intlayer/tree/main/docs/pt/packages/intlayer-cli/index.md) e [intlayer](https://github.com/aymericzip/intlayer/tree/main/docs/pt/packages/intlayer/index.md).
+
+## Instalação
+
+Instale o pacote necessário usando seu gerenciador de pacotes preferido:
+
+```bash packageManager="npm"
+npm install @intlayer/cli
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/cli
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/cli
+```
+
+## Histórico da Documentação
+
+- 5.5.10 - 2025-06-29: Histórico inicial

package/docs/pt/packages/@intlayer/config/index.md

@@ -0,0 +1,140 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/config - Gestão de Configuração para Intlayer
+description: Pacote NPM para recuperar a configuração do Intlayer e definir variáveis de ambiente para configurações de internacionalização em diferentes ambientes.
+keywords:
+  - intlayer
+  - configuração
+  - ambiente
+  - configurações
+  - i18n
+  - JavaScript
+  - NPM
+  - variáveis
+slugs:
+  - doc
+  - package
+  - @intlayer_config
+---
+
+# @intlayer/config: Pacote NPM para recuperar a configuração do Intlayer
+
+**Intlayer** é um conjunto de pacotes projetados especificamente para desenvolvedores JavaScript. É compatível com frameworks como React, React e Express.js.
+
+O pacote **`@intlayer/config`** é um pacote NPM que permite recuperar a configuração do Intlayer e definir as variáveis de ambiente relacionadas ao ambiente atual.
+
+## Instalação
+
+Instale o pacote necessário usando seu gerenciador de pacotes preferido:
+
+```bash packageManager="npm"
+npm install @intlayer/config
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/config
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/config
+```
+
+## Uso
+
+### Ler a configuração do Intlayer usando o sistema de arquivos
+
+Exemplo:
+
+```ts
+import { getConfiguration, type IntlayerConfig } from "@intlayer/config";
+
+const config: IntlayerConfig = getConfiguration();
+
+console.log(config);
+// Saída:
+// {
+//   internationalization: { ... },
+//   middleware: { ... },
+//   content: { ... },
+//   editor: { ... }
+// }
+```
+
+> Esta função usa o pacote `fs` e funcionará apenas no lado do servidor.
+
+### Ler a configuração do Intlayer usando variáveis de ambiente
+
+Exemplo:
+
+```ts
+import { getConfiguration, type IntlayerConfig } from "@intlayer/config/client";
+
+const config: IntlayerConfig = getConfiguration({
+  env: "production",
+});
+
+console.log(config);
+// Saída:
+// {
+//   internationalization: { ... },
+//   middleware: { ... },
+//   content: { ... },
+//   editor: { ... }
+// }
+```
+
+> Esta função não retornará nada se as variáveis de ambiente não estiverem definidas.
+
+### Definir as variáveis de ambiente
+
+1. Crie um arquivo de configuração.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    /* ... */
+  },
+  middleware: {
+    /* ... */
+  },
+  content: {
+    /* ... */
+  },
+  editor: {
+    /* ... */
+  },
+};
+
+export default config;
+```
+
+> Veja a [documentação de configuração do Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md) para mais detalhes.
+
+2. Defina as variáveis de ambiente.
+
+```ts
+import { getConfiguration } from "@intlayer/config";
+
+const intlayerConfig = getConfiguration();
+
+// Formate todos os valores de configuração como variáveis de ambiente
+const env = formatEnvVariable();
+
+// Defina cada variável de ambiente formatada em process.env
+Object.assign(process.env, env);
+```
+
+3. Importe o arquivo de configuração.
+
+```ts
+import { getConfiguration } from "@intlayer/config/client";
+
+const intlayerConfig = getConfiguration();
+```
+
+## Histórico do Documento
+
+- 5.5.10 - 2025-06-29: Histórico inicial