@intlayer/docs 8.12.4 → 9.0.0-canary.10

package/blog/pl/list_i18n_technologies/frameworks/react-native.md

@@ -16,6 +16,7 @@ slugs:
   - i18n-technologies
   - frameworks
   - react-native
+author: aymericzip
 ---
 
 # Eksploracja rozwiązań i18n do tłumaczenia Twojej aplikacji React Native

package/blog/pl/list_i18n_technologies/frameworks/react.md

@@ -16,6 +16,7 @@ slugs:
   - i18n-technologies
   - frameworks
   - react
+author: aymericzip
 ---
 
 # Eksploracja rozwiązań i18n do tłumaczenia Twojej strony React

package/blog/pl/list_i18n_technologies/frameworks/svelte.md

@@ -16,6 +16,7 @@ slugs:
   - i18n-technologies
   - frameworks
   - svelte
+author: aymericzip
 ---
 
 # Eksploracja rozwiązań i18n do tłumaczenia Twojej strony Svelte

package/blog/pl/list_i18n_technologies/frameworks/vue.md

@@ -16,6 +16,7 @@ slugs:
   - i18n-technologies
   - frameworks
   - vue
+author: aymericzip
 ---
 
 # Eksploracja rozwiązań i18n do tłumaczenia Twojej strony Vue.js

package/blog/pl/next-i18next_vs_next-intl_vs_intlayer.md

@@ -15,6 +15,7 @@ keywords:
 slugs:
   - blog
   - next-i18next-vs-next-intl-vs-intlayer
+author: aymericzip
 ---
 
 # next-i18next VS next-intl VS intlayer | Internacjonalizacja (i18n) Next.js

package/blog/pl/nextjs-multilingual-seo-comparison.md

@@ -16,6 +16,7 @@ keywords:
 slugs:
   - blog
   - blog-seo-i18n-nextjs
+author: aymericzip
 ---
 
 # SEO i i18n w Next.js: Tłumaczenie to za mało

package/blog/pl/per-component_vs_centralized_i18n.md

@@ -13,6 +13,7 @@ keywords:
 slugs:
   - blog
   - per-component-vs-centralized-i18n
+author: aymericzip
 ---
 
 # i18n per-komponentowy kontra scentralizowany

package/blog/pl/rag_powered_documentation_assistant.md

@@ -13,6 +13,7 @@ keywords:
 slugs:
   - blog
   - rag-powered-documentation-assistant
+author: aymericzip
 ---
 
 # Budowanie asystenta dokumentacji opartego na RAG (dzielenie na fragmenty, osadzenia i wyszukiwanie)
@@ -69,13 +70,17 @@ Na wysokim poziomie, oto przepis, którego użyłem:
 5.  **Augmentacja + Generacja (AG w RAG)** Te fragmenty są wstrzykiwane do promptu dla ChatGPT, dzięki czemu model odpowiada z wykorzystaniem rzeczywistego kontekstu dokumentacji.
 6.  **Logowanie zapytań dla informacji zwrotnej** Każde zapytanie użytkownika jest zapisywane. To złoto dla zrozumienia problemów, brakujących dokumentów lub nowych możliwości.
 
-## Krok 1: Odczytywanie dokumentacji
+<Steps>
+
+<Step number={1} title="Odczytywanie dokumentacji">
 
 Pierwszy krok był prosty: potrzebowałem sposobu na zeskanowanie folderu docs/ pod kątem wszystkich plików .md. Używając Node.js i glob, pobrałem zawartość każdego pliku Markdown do pamięci.
 
 To utrzymuje elastyczność pipeline’u: zamiast Markdown, możesz pobierać dokumentację z bazy danych, CMS-a lub nawet API.
 
-## Krok 2: Dzielenie dokumentacji na fragmenty
+</Step>
+
+<Step number={2} title="Dzielenie dokumentacji na fragmenty">
 
 Dlaczego dzielić? Ponieważ modele językowe mają **ograniczenia kontekstu**. Podanie im całej książki dokumentacji nie zadziała.
 
@@ -97,7 +102,9 @@ Ten kompromis (rozmiar fragmentu vs nakładanie) jest kluczowy dla efektywności
 - Zbyt mały → pojawia się szum.
 - Zbyt duży → rozrasta się rozmiar kontekstu.
 
-## Krok 3: Generowanie embeddingów
+</Step>
+
+<Step number={3} title="Generowanie embeddingów">
 
 Gdy dokumenty są podzielone na fragmenty, generujemy **embeddingi**, wektory o wysokim wymiarze reprezentujące każdy fragment.
 
@@ -115,7 +122,9 @@ Użyłem modelu OpenAI text-embedding-3-large, ale można użyć dowolnego nowoc
 
 Każdy wektor jest matematycznym odciskiem tekstu, umożliwiającym wyszukiwanie podobieństw.
 
-## Krok 4: Indeksowanie i przechowywanie embeddingów
+</Step>
+
+<Step number={4} title="Indeksowanie i przechowywanie embeddingów">
 
 Aby uniknąć wielokrotnego generowania embeddingów, zapisałem je w pliku embeddings.json.
 
@@ -128,7 +137,9 @@ W środowisku produkcyjnym prawdopodobnie będziesz chciał użyć bazy danych w
 
 Bazy danych wektorów zajmują się indeksowaniem, skalowalnością i szybkim wyszukiwaniem. Jednak w moim prototypie lokalny plik JSON sprawdził się dobrze.
 
-## Krok 5: Wyszukiwanie z użyciem podobieństwa kosinusowego
+</Step>
+
+<Step number={5} title="Wyszukiwanie z użyciem podobieństwa kosinusowego">
 
 Gdy użytkownik zada pytanie:
 
@@ -140,7 +151,9 @@ Podobieństwo cosinusowe mierzy kąt między dwoma wektorami. Idealne dopasowani
 
 W ten sposób system znajduje najbliższe fragmenty dokumentacji do zapytania.
 
-## Krok 6: Rozszerzanie + Generowanie
+</Step>
+
+<Step number={6} title="Rozszerzanie + Generowanie">
 
 Teraz zaczyna się magia. Bierzemy najlepsze fragmenty i wstrzykujemy je do **systemowego promptu** dla ChatGPT.
 
@@ -148,7 +161,9 @@ Oznacza to, że model odpowiada, jakby te fragmenty były częścią rozmowy.
 
 Efekt: dokładne, **odpowiedzi oparte na dokumentacji**.
 
-## Krok 7: Rejestrowanie zapytań użytkowników
+</Step>
+
+<Step number={7} title="Rejestrowanie zapytań użytkowników">
 
 To jest ukryta supermoc.
 
@@ -161,7 +176,9 @@ Każde zadane pytanie jest zapisywane. Z czasem budujesz zbiór danych zawieraj
 
 To zamienia Twojego asystenta RAG w **narzędzie do ciągłych badań użytkowników**.
 
-## Ile to kosztuje?
+</Step>
+
+<Step number={8} title="Ile to kosztuje?">
 
 Jednym z częstych zarzutów wobec RAG jest koszt. W praktyce jest zaskakująco tani:
 
@@ -171,7 +188,9 @@ Jednym z częstych zarzutów wobec RAG jest koszt. W praktyce jest zaskakująco
 
 Do tego dochodzi koszt hostingu.
 
-## Szczegóły implementacji
+</Step>
+
+<Step number={9} title="Szczegóły implementacji">
 
 Stack:
 
@@ -235,7 +254,9 @@ Eksperymentowaliśmy z gpt-5, ale opóźnienia były zbyt duże (czasami do 15 s
 
 👉 [Wypróbuj demo tutaj](https://intlayer.org/doc/pl/why) 👉 [Sprawdź szablon kodu na GitHub](https://github.com/aymericzip/smart_doc_RAG)
 
-## Idąc dalej
+</Step>
+
+<Step number={10} title="Idąc dalej">
 
 Ten projekt to minimalna implementacja. Możesz ją jednak rozbudować na wiele sposobów:
 
@@ -247,13 +268,17 @@ Ten projekt to minimalna implementacja. Możesz ją jednak rozbudować na wiele
 - Wieloźródłowe pobieranie → pobieranie nie tylko dokumentów, ale też wpisów z baz danych, postów na blogach, zgłoszeń itp.
 - Ulepszone promptowanie → ponowne rankowanie, filtrowanie i wyszukiwanie hybrydowe (słowo kluczowe + semantyczne)
 
-## Ograniczenia, na które natrafiliśmy
+</Step>
+
+<Step number={11} title="Ograniczenia, na które natrafiliśmy">
 
 - Dzielenie na fragmenty i nakładanie się jest empiryczne. Odpowiednia równowaga (rozmiar fragmentu, procent nakładania, liczba pobieranych fragmentów) wymaga iteracji i testowania.
 - Embeddingi nie są automatycznie regenerowane, gdy dokumentacja się zmienia. Nasz system resetuje embeddingi dla pliku tylko wtedy, gdy liczba fragmentów różni się od zapisanej.
 - W tym prototypie embeddingi są przechowywane w formacie JSON. Działa to w demo, ale zaśmieca repozytorium Git. W produkcji lepsza jest baza danych lub dedykowany magazyn wektorów.
 
-## Dlaczego to ma znaczenie poza dokumentacją
+</Step>
+
+<Step number={12} title="Dlaczego to ma znaczenie poza dokumentacją">
 
 Interesująca jest nie tylko sama chatbot. To jest **pętla informacji zwrotnej**.
 
@@ -273,7 +298,9 @@ Wyobraź sobie, że wprowadzasz nową funkcję i natychmiast widzisz:
 
 To jest **inteligencja produktowa** prosto od Twoich użytkowników.
 
-## Podsumowanie
+</Step>
+
+<Step number={13} title="Podsumowanie">
 
 RAG to jeden z najprostszych i najpotężniejszych sposobów na praktyczne wykorzystanie LLM. Łącząc **wyszukiwanie + generowanie**, możesz przekształcić statyczną dokumentację w **inteligentnego asystenta** i jednocześnie uzyskać ciągły strumień informacji o produkcie.
 
@@ -286,3 +313,20 @@ Dla mnie ten projekt pokazał, że RAG to nie tylko techniczny trik. To sposób
 👉 [Wypróbuj demo tutaj](https://intlayer.org/doc/why) 👉 [Sprawdź szablon kodu na GitHub](https://github.com/aymericzip/smart_doc_RAG)
 
 A jeśli również eksperymentujesz z RAG, chętnie usłyszę, jak go używasz.
+
+</Step>
+
+</Steps>
+## Podsumowanie
+
+RAG to jeden z najprostszych i zarazem najpotężniejszych sposobów na uczynienie LLM praktycznymi. Łącząc **retrieval + generation**, możesz zamienić statyczną dokumentację w **inteligentnego asystenta** i jednocześnie uzyskać ciągły strumień informacji o produkcie.
+
+Dla mnie ten projekt pokazał, że RAG to nie tylko techniczny trik. To sposób na transformację dokumentacji w:
+
+- interaktywny system wsparcia
+- kanał do zbierania opinii
+- narzędzie strategii produktu
+
+👉 [Spróbuj demo tutaj](https://intlayer.org/doc/why) 👉 [Sprawdź szablon kodu na GitHubie](https://github.com/aymericzip/smart_doc_RAG)
+
+A jeśli ty też eksperymentujesz z RAG, chętnie usłyszę, jak go wykorzystujesz.

package/blog/pl/react-i18next_vs_react-intl_vs_intlayer.md

@@ -15,6 +15,7 @@ keywords:
 slugs:
   - blog
   - react-i18next-vs-react-intl-vs-intlayer
+author: aymericzip
 ---
 
 # react-Intl VS react-i18next VS intlayer | Internacjonalizacja React (i18n)

package/blog/pl/vue-i18n_vs_intlayer.md

@@ -15,6 +15,7 @@ keywords:
 slugs:
   - blog
   - vue-i18n-vs-intlayer
+author: aymericzip
 ---
 
 # vue-i18n VS Intlayer | Internacjonalizacja Vue (i18n)

package/blog/pl/what_is_internationalization.md

@@ -15,6 +15,7 @@ keywords:
 slugs:
   - blog
   - what-is-internationalization
+author: aymericzip
 ---
 
 # Czym jest internacjonalizacja (i18n)? Definicja i wyzwania

package/blog/pt/compiler_vs_declarative_i18n.md

@@ -16,6 +16,7 @@ keywords:
 slugs:
   - blog
   - compiler-vs-declarative-i18n
+author: aymericzip
 ---
 
 # O Caso a Favor e Contra a i18n Baseada em Compilador

package/blog/pt/i18n_meaning.md

@@ -14,6 +14,7 @@ keywords:
 slugs:
   - blog
   - i18n-meaning
+author: aymericzip
 ---
 
 # Significado de i18n: O que é Internacionalização e por que ela é importante?

package/blog/pt/i18n_using_next-i18next.md

@@ -19,6 +19,7 @@ history:
   - version: 7.0.6
     date: 2025-11-01
     changes: Versão inicial
+author: aymericzip
 ---
 
 # Como internacionalizar sua aplicação Next.js usando next-i18next em 2026

package/blog/pt/i18n_using_next-intl.md

@@ -18,6 +18,7 @@ history:
   - version: 7.0.0
     date: 2025-11-01
     changes: Versão inicial
+author: aymericzip
 ---
 
 # Como internacionalizar sua aplicação Next.js usando next-intl em 2026

package/blog/pt/index.md

@@ -13,6 +13,7 @@ keywords:
 slugs:
   - blog
   - search
+author: aymericzip
 ---
 
 # Abraçando a Internacionalização em JavaScript: Aumentando o Alcance Global e SEO

package/blog/pt/internationalization_and_SEO.md

@@ -14,6 +14,7 @@ keywords:
 slugs:
   - blog
   - SEO-and-i18n
+author: aymericzip
 ---
 
 # SEO & I18n: O Guia Definitivo para Tornar Seu Site Multilíngue
@@ -112,7 +113,7 @@ No seu HTML, você adicionará algo como:
    - Você deve apenas traduzir o texto e os títulos do arquivo.
    - Você não deve alterar a estrutura do arquivo.
    - Você não deve alterar a lógica do código dos elementos de código.
-   - Você deve transformar URLs como `https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/**/*.md` em `https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/**/*.md`
+   - Você deve transformar URLs como `https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/**/*.md` em `https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/**/*.md`
    - Você não deve transformar URLs como `https://github.com/aymericzip/intlayer/blob/main/docs/assets/**/*`
    - Você deve transformar URLs de local como `/**/*` em `/{{locale}}/**/*`
    - Nos elementos de código, a nomeação das variáveis deve ser feita em inglês. Mas os comentários devem ser em português.

package/blog/pt/intlayer_with_i18next.md

@@ -27,12 +27,17 @@ history:
   - version: 7.0.0
     date: 2025-10-29
     changes: Alterado para plugin syncJSON
+author: aymericzip
 ---
 
 # Como automatizar suas traduções JSON do i18next usando Intlayer
 
 <iframe title="Como automatizar suas traduções JSON do i18next usando Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/MpGMxniDHNg?autoplay=0&amp;origin=https://intlayer.org&amp;controls=0&amp;rel=1"/>
 
+## Sumário
+
+<TOC/>
+
 ## O que é o Intlayer?
 
 **Intlayer** é uma biblioteca inovadora e open-source de internacionalização, projetada para resolver as limitações das soluções tradicionais de i18n. Ela oferece uma abordagem moderna para o gerenciamento de conteúdo em aplicações JavaScript.
@@ -58,28 +63,46 @@ Este guia mostra como aproveitar o sistema superior de declaração de conteúdo
 
 ## Guia passo a passo para configurar o Intlayer com o i18next
 
-### Passo 1: Instalar dependências
+<Steps>
+
+<Step number={1} title="Instalar dependências">
 
 Instale os pacotes necessários:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> a flag `--interactive` é opcional. Use `intlayer-cli init` se você for um agente de IA.
+
+> Este comando detectará seu ambiente e instalará os pacotes necessários. Por exemplo:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/sync-json-plugin --dev
-bun x intlayer init
 ```
 
 **Descrição dos pacotes:**
@@ -87,7 +110,9 @@ bun x intlayer init
 - **intlayer**: Biblioteca principal para gerenciamento de internacionalização, declaração de conteúdo e construção
 - **@intlayer/sync-json-plugin**: Plugin para exportar declarações de conteúdo do Intlayer para o formato JSON compatível com i18next
 
-### Passo 2: Implemente o plugin Intlayer para encapsular o JSON
+</Step>
+
+<Step number={2} title="Implemente o plugin Intlayer para encapsular o JSON">
 
 Crie um arquivo de configuração do Intlayer para definir os seus locais suportados:
 
@@ -123,7 +148,9 @@ Se alterações forem feitas usando a CLI para traduzir o JSON, ou usando o CMS,
 
 Para ver mais detalhes sobre o plugin `syncJSON`, consulte a [documentação do plugin syncJSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/plugins/sync-json.md).
 
-### (Opcional) Passo 3: Implementar traduções JSON por componente
+</Step>
+
+<Step number={3} title="Implementar traduções JSON por componente" isOptional={true}>
 
 Por padrão, o Intlayer irá carregar, mesclar e sincronizar tanto os arquivos JSON quanto os arquivos de declaração de conteúdo. Veja [a documentação da declaração de conteúdo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/content_file.md) para mais detalhes. Mas, se preferir, usando um plugin do Intlayer, você também pode implementar o gerenciamento por componente de JSON localizado em qualquer lugar da sua base de código.
 
@@ -166,6 +193,10 @@ Isso carregará todos os arquivos JSON no diretório `src` que correspondem ao p
 
 ---
 
+</Step>
+
+</Steps>
+
 ## Configuração do Git
 
 É recomendado ignorar os arquivos gerados automaticamente pelo Intlayer:

package/blog/pt/intlayer_with_next-i18next.md

@@ -23,6 +23,7 @@ history:
   - version: 7.0.0
     date: 2025-10-29
     changes: Alterado para plugin syncJSON e reescrita abrangente
+author: aymericzip
 ---
 
 # Internacionalização (i18n) Next.js com next-i18next e Intlayer
@@ -33,17 +34,6 @@ history:
 
 <TOC/>
 
-## O que é o next-i18next?
-
-**next-i18next** é um dos frameworks de internacionalização (i18n) mais populares para aplicações Next.js. Construído sobre o poderoso ecossistema **i18next**, ele oferece uma solução abrangente para gerenciar traduções, localização e troca de idiomas em projetos Next.js.
-
-No entanto, o next-i18next apresenta alguns desafios:
-
-- **Configuração complexa**: Configurar o next-i18next requer múltiplos arquivos de configuração e uma configuração cuidadosa das instâncias i18n no lado do servidor e do cliente.
-- **Traduções dispersas**: Os arquivos de tradução geralmente são armazenados em diretórios separados dos componentes, dificultando a manutenção da consistência.
-- **Gerenciamento manual de namespaces**: Os desenvolvedores precisam gerenciar manualmente os namespaces e garantir o carregamento adequado dos recursos de tradução.
-- **Segurança de tipos limitada**: O suporte ao TypeScript requer configuração adicional e não fornece geração automática de tipos para traduções.
-
 ## O que é o Intlayer?
 
 **Intlayer** é uma biblioteca inovadora e de código aberto para internacionalização, projetada para resolver as limitações das soluções tradicionais de i18n. Ela oferece uma abordagem moderna para o gerenciamento de conteúdo em aplicações Next.js.
@@ -66,28 +56,46 @@ Este guia mostra como aproveitar o sistema superior de declaração de conteúdo
 
 ## Guia Passo a Passo para Configurar o Intlayer com next-i18next
 
-### Passo 1: Instalar Dependências
+<Steps>
+
+<Step number={1} title="Instalar Dependências">
 
 Instale os pacotes necessários usando seu gerenciador de pacotes preferido:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> a flag `--interactive` é opcional. Use `intlayer-cli init` se você for um agente de IA.
+
+> Este comando detectará seu ambiente e instalará os pacotes necessários. Por exemplo:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/sync-json-plugin --dev
-bun x intlayer init
 ```
 
 **Explicações dos pacotes:**
@@ -95,7 +103,9 @@ bun x intlayer init
 - **intlayer**: Biblioteca principal para declaração e gerenciamento de conteúdo
 - **@intlayer/sync-json-plugin**: Plugin para sincronizar declarações de conteúdo do Intlayer para o formato JSON do i18next
 
-### Passo 2: Implemente o plugin Intlayer para encapsular o JSON
+</Step>
+
+<Step number={2} title="Implemente o plugin Intlayer para encapsular o JSON">
 
 Crie um arquivo de configuração do Intlayer para definir os locais suportados:
 
@@ -133,7 +143,9 @@ Para ver mais detalhes sobre o plugin `syncJSON`, por favor consulte a [document
 
 ---
 
-### (Opcional) Passo 3: Implementar traduções JSON por componente
+</Step>
+
+<Step number={3} title="Implementar traduções JSON por componente" isOptional={true}>
 
 Por padrão, o Intlayer irá carregar, mesclar e sincronizar tanto os arquivos JSON quanto os arquivos de declaração de conteúdo. Veja [a documentação da declaração de conteúdo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/content_file.md) para mais detalhes. Mas se preferir, usando um plugin do Intlayer, você também pode implementar o gerenciamento por componente de JSON localizado em qualquer lugar da sua base de código.
 
@@ -176,6 +188,10 @@ Isso irá carregar todos os arquivos JSON no diretório `src` que correspondem a
 
 ---
 
+</Step>
+
+</Steps>
+
 ## Configuração do Git
 
 Exclua arquivos gerados do controle de versão:

package/blog/pt/intlayer_with_next-intl.md

@@ -22,12 +22,17 @@ history:
   - version: 7.0.0
     date: 2025-10-29
     changes: Alterado para plugin syncJSON
+author: aymericzip
 ---
 
 # Como automatizar suas traduções JSON do next-intl usando Intlayer
 
 <iframe title="Como automatizar suas traduções JSON do next-intl usando Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/MpGMxniDHNg?autoplay=0&amp;origin=https://intlayer.org&amp;controls=0&amp;rel=1"/>
 
+# Índice
+
+<TOC/>
+
 ## O que é Intlayer?
 
 **Intlayer** é uma biblioteca inovadora e de código aberto para internacionalização, projetada para resolver as limitações das soluções tradicionais de i18n. Ela oferece uma abordagem moderna para o gerenciamento de conteúdo em aplicações Next.js.
@@ -52,28 +57,46 @@ Este guia mostra como aproveitar o sistema superior de declaração de conteúdo
 
 ## Guia passo a passo para configurar o Intlayer com next-intl
 
-### Passo 1: Instalar dependências
+<Steps>
+
+<Step number={1} title="Instalar dependências">
 
 Instale os pacotes necessários:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> a flag `--interactive` é opcional. Use `intlayer-cli init` se você for um agente de IA.
+
+> Este comando detectará seu ambiente e instalará os pacotes necessários. Por exemplo:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/sync-json-plugin --dev
-bun x intlayer init
 ```
 
 **Descrição dos pacotes:**
@@ -81,7 +104,9 @@ bun x intlayer init
 - **intlayer**: Biblioteca principal para gerenciamento de internacionalização, declaração de conteúdo e construção
 - **@intlayer/sync-json-plugin**: Plugin para exportar declarações de conteúdo do Intlayer para o formato JSON compatível com next-intl
 
-### Passo 2: Implemente o plugin Intlayer para encapsular o JSON
+</Step>
+
+<Step number={2} title="Implemente o plugin Intlayer para encapsular o JSON">
 
 Crie um arquivo de configuração do Intlayer para definir os locais suportados:
 
@@ -118,7 +143,9 @@ Se alterações forem feitas usando o CLI para traduzir o JSON, ou usando o CMS,
 
 Para ver mais detalhes sobre o plugin `syncJSON`, por favor consulte a [documentação do plugin syncJSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/plugins/sync-json.md).
 
-### (Opcional) Passo 3: Implementar traduções JSON por componente
+</Step>
+
+<Step number={3} title="Implementar traduções JSON por componente" isOptional={true}>
 
 Por padrão, o Intlayer carregará, mesclará e sincronizará tanto os arquivos JSON quanto os arquivos de declaração de conteúdo. Veja [a documentação de declaração de conteúdo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/content_file.md) para mais detalhes. Mas, se preferir, usando um plugin do Intlayer, você também pode implementar o gerenciamento por componente de JSON localizado em qualquer lugar da sua base de código.
 
@@ -160,6 +187,10 @@ export default config;
 
 Isso carregará todos os arquivos JSON no diretório `src` que correspondem ao padrão `{key}.i18n.json` e os carregará como dicionários do Intlayer.
 
+</Step>
+
+</Steps>
+
 ## Configuração do Git
 
 É recomendado ignorar os arquivos gerados automaticamente pelo Intlayer: