@intlayer/docs 9.0.0-canary.5 → 9.0.0-canary.6

package/docs/pl/intlayer_with_react_native+expo.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-06-18
-updatedAt: 2026-05-31
+updatedAt: 2026-06-25
 title: "Expo + React Native i18n - Kompletny przewodnik po tłumaczeniu swojej aplikacji"
 description: "Koniec z i18next. Przewodnik 2026 do budowania wielojęzycznej (i18n) aplikacji Expo + React Native. Tłumacz z agentami AI i optymalizuj rozmiar bundle, SEO i wydajność."
 keywords:
@@ -17,6 +17,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-react-native-template
 applicationShowcase: https://intlayer-react-native.vercel.app
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Importowanie providerów i hooków bezpośrednio z react-native-intlayer; react-intlayer nie jest już potrzebny jako bezpośrednia zależność"
   - version: 8.9.0
     date: 2026-05-04
     changes: "Aktualizacja użycia API useIntlayer w Solid do bezpośredniego dostępu do właściwości"
@@ -63,38 +66,55 @@ author: aymericzip
 
 <TOC/>
 
-## Dlaczego Interlayer zamiast alternatyw?
+## Dlaczego Intlayer zamiast alternatyw?
 
-W porównaniu do głównych rozwiązań, takich jak „react-native-localize” czy „i18next”, Intlayer jest rozwiązaniem wyposażonym w zintegrowane optymalizacje, takie jak:
+W porównaniu do głównych rozwiązań, takich jak `react-native-localize` czy `i18next`, Intlayer jest rozwiązaniem wyposażonym w zintegrowane optymalizacje, takie jak:
 
-**Pełne pokrycie React Native**
+<AccordionGroup>
+
+<Accordion header="Pełne pokrycie React Native">
 
 Intlayer jest zoptymalizowany do doskonałej współpracy z React Native i Expo, oferując **zakres treści na poziomie komponentów**, **obsługę TypeScript** i wszystkie funkcje potrzebne do skalowania internacjonalizacji (i18n) w aplikacjach mobilnych.
 
-**Łatwość konserwacji**
+</Accordion>
+
+<Accordion header="Łatwość konserwacji">
+
+Określanie zakresu zawartości aplikacji **ułatwia konserwację** aplikacji na dużą skalę. Możesz powielić lub usunąć pojedynczy folder funkcji bez obciążania psychicznego koniecznością przeglądania całej bazy kodu zawartości. Dodatkowo Intlayer jest **w pełni typowany**, aby zapewnić dokładność treści.
+
+</Accordion>
+
+<Accordion header="Agent AI">
 
-Określanie zakresu zawartości aplikacji **ułatwia konserwację** aplikacji na dużą skalę. Możesz powielić lub usunąć pojedynczy folder funkcji bez obciążania psychicznego koniecznością przeglądania całej bazy kodu zawartości. Dodatkowo Inlayer jest **w pełni napisany**, aby zapewnić dokładność treści.
+Wspólna lokalizacja treści **zmniejsza potrzebny kontekst** dzięki modelom dużego języka (LLM). Intlayer zawiera także zestaw narzędzi, takich jak **CLI** do sprawdzania brakujących tłumaczeń, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** i **[umiejętności agenta](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**, aby praca programisty (DX) była jeszcze płynniejsza dla agentów AI.
 
-**Agent AI**
+</Accordion>
 
-Wspólna lokalizacja treści **zmniejsza potrzebny kontekst** dzięki modelom dużego języka (LLM). Intlayer zawiera także zestaw narzędzi, taki jak **CLI** do sprawdzania brakujących tłumaczeń**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** i **[umiejętności agenta](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**, aby praca programisty (DX) była jeszcze płynniejsza dla agentów AI.
+<Accordion header="Automatyzacja">
 
-**Automatyzacja**
+Korzystaj z automatyzacji, aby tłumaczyć w swoim potoku CI/CD przy użyciu wybranego LLM na koszt dostawcy sztucznej inteligencji. Intlayer oferuje także **kompilator** do automatyzacji ekstrakcji treści, a także [platformę internetową](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md), która pomaga **tłumaczyć w tle**.
 
-Korzystaj z automatyzacji, aby tłumaczyć w swoim potoku CI/CD przy użyciu wybranego LLM na koszt dostawcy sztucznej inteligencji. Intlayer oferuje także **kompilator** do automatyzacji ekstrakcji treści, a także [platformę internetową] (https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md), która pomaga **tłumaczyć w tle**.
+</Accordion>
 
-**Wydajność**
+<Accordion header="Wydajność">
 
-Łączenie ogromnych plików JSON z komponentami może prowadzić do problemów z wydajnością i reaktywnością. Inlayer optymalizuje ładowanie treści w czasie kompilacji.
+Łączenie ogromnych plików JSON z komponentami może prowadzić do problemów z wydajnością i reaktywnością. Intlayer optymalizuje ładowanie treści w czasie kompilacji.
 
-**Skalowanie bez użycia dewelopera**
+</Accordion>
 
-Więcej niż tylko rozwiązanie i18n, Intlayer zapewnia **samodzielny [edytor wizualny](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** i **[pełny CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)**, który pomoże Ci zarządzać wielojęzyczną treścią w **w czasie rzeczywistym**, dzięki czemu współpraca z tłumaczami, copywriterami i innymi członkami zespołu będzie płynna. Treść może być przechowywana lokalnie i/lub zdalnie.
+<Accordion header="Skalowanie bez użycia dewelopera">
 
-**Rozmiar bundle'a**
+Więcej niż tylko rozwiązanie i18n, Intlayer zapewnia **samodzielny [edytor wizualny](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** i **[pełny CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)**, który pomoże Ci zarządzać wielojęzyczną treścią w **czasie rzeczywistym**, dzięki czemu współpraca z tłumaczami, copywriterami i innymi członkami zespołu będzie płynna. Treść może być przechowywana lokalnie i/lub zdalnie.
+
+</Accordion>
+
+<Accordion header="Rozmiar bundle'a">
 
 Zamiast ładować ogromne pliki JSON na swoje strony, ładuj tylko niezbędną treść. Intlayer pomaga **zmniejszyć rozmiary pakietów i wyświetleń nawet o 50%**.
 
+</Accordion>
+</AccordionGroup>
+
 <Steps>
 
 <Step number={1} title="Zainstaluj zależności">
@@ -103,28 +123,40 @@ Zobacz [Szablon aplikacji](https://github.com/aymericzip/intlayer-react-native-t
 
 Z projektu React Native zainstaluj następujące pakiety:
 
-```menedżer pakietów bash="npm"
-npm zainstaluj warstwę pośrednią, reagującą warstwę pośrednią
-npm install --save-dev reagują-native-intlayer
-inicjacja międzywarstwy npx
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
 ```
 
-```menedżer pakietów bash="pnpm"
-pnpm dodaj warstwę pośrednią, reagującą warstwę wewnętrzną
-pnpm add --save-dev reagują-native-intlayer
-pnpm inicjacja warstwy międzywarstwowej
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
 ```
 
-```bash packageManager="przędza"
-przędza dodaje warstwę pośrednią, reagującą na warstwę wewnętrzną
-przędza dodaj --save-dev reagująca-natywna-warstwa
-init międzywarstwy przędzy
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
 ```
 
-```menedżer pakietów bash="bułka"
-bułka dodaj warstwę pośrednią, zareaguj na warstwę wewnętrzną
-bun add --dev reagują-native-intlayer
-kok x inicjacja międzywarstwy
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> Flaga `--interactive` jest opcjonalna. Użyj `intlayer-cli init`, jeśli jesteś agentem AI.
+
+> To polecenie wykryje Twoje środowisko i zainstaluje wymagane pakiety. Na przykład:
+
+```bash packageManager="npm"
+npm install intlayer react-native-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer react-native-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add intlayer react-native-intlayer
+```
+
+```bash packageManager="bun"
+bun add intlayer react-native-intlayer
 ```
 
 ### Pakiety
@@ -132,17 +164,14 @@ kok x inicjacja międzywarstwy
 - **intlayer**  
   Podstawowe narzędzie i18n do konfiguracji, zawartości słownika, generowania typów oraz poleceń CLI.
 
-- **react-intlayer**  
-  Integracja z React, która dostarcza dostawców kontekstu oraz hooki React, których użyjesz w React Native do pobierania i przełączania lokalizacji.
-
 - **react-native-intlayer**  
-  Integracja z React Native, która dostarcza wtyczkę Metro do integracji Intlayer z bundlerem React Native.
+  Integracja z React Native, która dostarcza dostawców kontekstu oraz hooki React do pobierania i przełączania lokalizacji, polyfille dla React Native oraz wtyczkę Metro do integracji Intlayer z bundlerem React Native. Reeksportuje wszystko z `react-intlayer`, więc w aplikacji React Native potrzebny jest tylko ten jeden pakiet.
 
 ---
 
 </Step>
 
-<Step number={3} title="Utwórz konfigurację Intlayer">
+<Step number={2} title="Utwórz konfigurację Intlayer">
 
 W katalogu głównym projektu (lub w dowolnym wygodnym miejscu) utwórz plik **konfiguracji Intlayer**. Może on wyglądać tak:
 
@@ -176,7 +205,7 @@ W ramach tej konfiguracji możesz:
 
 </Step>
 
-<Step number={4} title="Dodaj wtyczkę Metro">
+<Step number={3} title="Dodaj wtyczkę Metro">
 
 Metro to bundler dla React Native. Jest to domyślny bundler dla projektów React Native tworzonych za pomocą polecenia `react-native init`. Aby używać Intlayer z Metro, musisz dodać wtyczkę do pliku `metro.config.js`:
 
@@ -196,11 +225,11 @@ module.exports = (async () => {
 
 </Step>
 
-<Step number={5} title="Dodaj dostawcę Intlayer">
+<Step number={4} title="Dodaj dostawcę Intlayer">
 
 Aby utrzymać synchronizację języka użytkownika w całej aplikacji, musisz opakować swój komponent root w komponent `IntlayerProvider` z `react-native-intlayer`.
 
-> Upewnij się, że używasz providera z `react-native-intlayer` zamiast `react-intlayer`. Eksport z `react-native-intlayer` zawiera polyfille dla web API.
+> Zawsze importuj z `react-native-intlayer`. Jego `IntlayerProvider` zawiera polyfille dla web API używanego przez Intlayer, a pakiet reeksportuje wszystkie hooki i narzędzia z `react-intlayer`.
 
 Dodatkowo, musisz dodać funkcję `intlayerPolyfill` do swojego pliku `index.js`, aby zapewnić prawidłowe działanie Intlayer.
 
@@ -227,7 +256,7 @@ export default RootLayout;
 
 </Step>
 
-<Step number={6} title="Zadeklaruj swoją zawartość">
+<Step number={5} title="Zadeklaruj swoją zawartość">
 
 Utwórz pliki **deklaracji zawartości** w dowolnym miejscu w swoim projekcie (zwykle w katalogu `src/`), używając dowolnego z formatów rozszerzeń obsługiwanych przez Intlayer:
 
@@ -298,7 +327,7 @@ export default homeScreenContent;
 
 </Step>
 
-<Step number={7} title="Użyj Intlayer w swoich komponentach">
+<Step number={6} title="Użyj Intlayer w swoich komponentach">
 
 Użyj hooka `useIntlayer` w komponentach potomnych, aby uzyskać zlokalizowaną zawartość.
 
@@ -306,7 +335,7 @@ Użyj hooka `useIntlayer` w komponentach potomnych, aby uzyskać zlokalizowaną
 
 ```tsx fileName="app/(tabs)/index.tsx" codeFormat={["typescript", "esm"]}
 import { Image, StyleSheet, Platform } from "react-native";
-import { useIntlayer } from "react-intlayer";
+import { useIntlayer } from "react-native-intlayer";
 import { HelloWave } from "@/components/HelloWave";
 import ParallaxScrollView from "@/components/ParallaxScrollView";
 import { ThemedText } from "@/components/ThemedText";
@@ -353,7 +382,7 @@ export default HomeScreen;
 
 </Step>
 
-<Step number={8} title="Zmiana lokalizacji aplikacji" isOptional={true}>
+<Step number={7} title="Zmiana lokalizacji aplikacji" isOptional={true}>
 
 Aby zmienić lokalizację z poziomu komponentów, możesz użyć metody `setLocale` hooka `useLocale`:
 
@@ -361,7 +390,7 @@ Aby zmienić lokalizację z poziomu komponentów, możesz użyć metody `setLoca
 import { type FC } from "react";
 import { View, Text, TouchableOpacity, StyleSheet } from "react-native";
 import { getLocaleName } from "intlayer";
-import { useLocale } from "react-intlayer";
+import { useLocale } from "react-native-intlayer";
 
 export const LocaleSwitcher: FC = () => {
   const { setLocale, availableLocales } = useLocale();
@@ -438,7 +467,7 @@ To umożliwia funkcje takie jak:
 Aby uniknąć zatwierdzania automatycznie generowanych plików przez Intlayer, dodaj następujące wpisy do swojego `.gitignore`:
 
 ```bash
-#  Ignoruj pliki generowane przez Intlayer
+# Ignoruj pliki generowane przez Intlayer
 .intlayer
 ```
 
@@ -479,7 +508,7 @@ Intlayer jest przede wszystkim skierowany do Web Intl API; na React Native musis
 
 Lista kontrolna:
 
-- Używaj najnowszych wersji `intlayer`, `react-intlayer` oraz `react-native-intlayer`.
+- Używaj najnowszych wersji `intlayer` oraz `react-native-intlayer`.
 - Włącz polyfill Intlayer.
 - Jeśli używasz `getLocaleName` lub innych narzędzi opartych na API Intl, zaimportuj te polyfille wcześnie (na przykład w `index.js` lub `App.tsx`):
 

package/docs/pl/packages/react-native-intlayer/exports.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-06-25
 title: Dokumentacja pakietu react-native-intlayer
-description: Wsparcie React Native dla Intlayer, zapewniające providerów i polyfille.
+description: Wsparcie React Native dla Intlayer, zapewniające providerów, hooki, polyfille i konfigurację Metro.
 keywords:
   - react-native-intlayer
   - react-native
@@ -14,6 +14,9 @@ slugs:
   - react-native-intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Reeksportowanie pełnego API react-intlayer (hooki, narzędzia, podścieżki format/html/markdown), aby aplikacja React Native zależała tylko od react-native-intlayer"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Ujednolicona dokumentacja dla wszystkich eksportów"
@@ -22,7 +25,9 @@ author: aymericzip
 
 # Pakiet react-native-intlayer
 
-Pakiet `react-native-intlayer` dostarcza niezbędne narzędzia do integracji Intlayer z aplikacjami React Native. Zawiera provider oraz polyfille wspierające obsługę lokalizacji.
+Pakiet `react-native-intlayer` dostarcza niezbędne narzędzia do integracji Intlayer z aplikacjami React Native. Reeksportuje pełne API `react-intlayer` (hooki i narzędzia) wraz z gotowym na React Native `IntlayerProvider`, a także polyfille i konfigurację Metro wymaganą przez React Native.
+
+> W aplikacji React Native importuj **wszystko** z `react-native-intlayer`. Nie musisz instalować ani importować `react-intlayer` bezpośrednio.
 
 ## Instalacja
 
@@ -34,14 +39,30 @@ npm install react-native-intlayer
 
 ### Provider
 
-| Komponent          | Opis                                                                             |
-| ------------------ | -------------------------------------------------------------------------------- |
-| `IntlayerProvider` | Komponent Provider, który otacza Twoją aplikację i udostępnia kontekst Intlayer. |
+| Komponent          | Opis                                                                                                                       |
+| ------------------ | -------------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerProvider` | Komponent Provider, który otacza Twoją aplikację i udostępnia kontekst Intlayer. Automatycznie stosuje wymagane polyfille. |
+
+```tsx
+import { IntlayerProvider } from "react-native-intlayer";
+```
+
+### Hooki i narzędzia
+
+Są reeksportowane z `react-intlayer`, więc możesz importować je bezpośrednio z `react-native-intlayer`:
 
-Import:
+| Eksport                                                                                                           | Opis                                                     |
+| ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
+| `useIntlayer`                                                                                                     | Dostęp do zlokalizowanej zawartości dla klucza słownika. |
+| `useLocale`                                                                                                       | Odczyt i zmiana bieżącej lokalizacji.                    |
+| `useDictionary`, `useDictionaryAsync`, `useDictionaryDynamic`, `useLoadDynamic`                                   | Ładowanie zawartości słownika na różne sposoby.          |
+| `useI18n`                                                                                                         | Hook kompatybilny z i18next.                             |
+| `t`                                                                                                               | Pomocnik tłumaczenia inline.                             |
+| `getIntlayer`, `getDictionary`                                                                                    | Imperatywne gettery zawartości.                          |
+| `localeCookie`, `localeInStorage`, `setLocaleCookie`, `setLocaleInStorage`, `useLocaleCookie`, `useLocaleStorage` | Pomocniki trwałości lokalizacji.                         |
 
 ```tsx
-import "react-native-intlayer";
+import { useIntlayer, useLocale, t } from "react-native-intlayer";
 ```
 
 ### Polyfill
@@ -50,10 +71,25 @@ import "react-native-intlayer";
 | ------------------ | ----------------------------------------------------------------------------------- |
 | `intlayerPolyfill` | Funkcja, która stosuje niezbędne polyfille dla React Native, aby wspierać Intlayer. |
 
-Import:
+```tsx
+import { intlayerPolyfill } from "react-native-intlayer";
+```
+
+> Polyfill jest stosowany automatycznie podczas importowania `IntlayerProvider`. Wywołaj `intlayerPolyfill` ręcznie tylko wtedy, gdy potrzebujesz polyfilli przed zamontowaniem providera.
+
+### Formatery
+
+Hooki do formatowania liczb, dat i inne oparte na Intl są dostępne z podścieżki `/format`:
+
+```tsx
+import { useNumber, useDate } from "react-native-intlayer/format";
+```
+
+### Renderowanie Markdown i HTML
 
 ```tsx
-import "react-native-intlayer";
+import { MarkdownProvider } from "react-native-intlayer/markdown";
+import { HTMLProvider } from "react-native-intlayer/html";
 ```
 
 ### Konfiguracja Metro
@@ -66,8 +102,6 @@ Pakiet `react-native-intlayer` dostarcza narzędzia do konfiguracji Metro, aby z
 | `configMetroIntlayerSync` | Funkcja synchroniczna, która scala konfigurację Metro bez przygotowywania zasobów Intlayer. |
 | `exclusionList`           | Tworzy wzorzec RegExp dla blockList Metro, aby wykluczyć pliki zawartości z bundla.         |
 
-Import:
-
 ```tsx
-import "react-native-intlayer/metro";
+import { configMetroIntlayer } from "react-native-intlayer/metro";
 ```

package/docs/pt/intlayer_with_react_native+expo.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-06-18
-updatedAt: 2026-05-31
+updatedAt: 2026-06-25
 title: "Expo + React Native i18n - Guia completo para traduzir seu aplicativo"
 description: "Sem mais i18next. O guia 2026 para criar uma aplicação Expo + React Native multilíngue (i18n). Traduza com agentes de IA e otimize o tamanho do bundle, SEO e desempenho."
 keywords:
@@ -17,12 +17,18 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-react-native-template
 applicationShowcase: https://intlayer-react-native.vercel.app
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Importar providers e hooks diretamente de react-native-intlayer; react-intlayer não é mais necessário como dependência direta"
   - version: 8.9.0
     date: 2026-05-04
     changes: "Atualizar o uso da API useIntlayer do Solid para acesso direto a propriedades"
   - version: 7.5.9
     date: 2025-12-30
     changes: "Adicionar comando init"
+  - version: 6.1.6
+    date: 2025-10-02
+    changes: "Adicionar seção de debug"
   - version: 5.5.10
     date: 2025-06-29
     changes: "Histórico inicial"
@@ -37,7 +43,7 @@ author: aymericzip
 <iframe
   src="https://ide.intlayer.org/aymericzip/intlayer-react-native-template?file=intlayer.config.ts"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Demo CodeSandbox - Intlayer"
+  title="Demo CodeSandbox - Como Internacionalizar sua aplicação usando Intlayer"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -56,7 +62,9 @@ author: aymericzip
   </Tab>
 </Tabs>
 
-Veja o [Modelo de Aplicação](https://github.com/aymericzip/intlayer-react-native-template) no GitHub.
+## Índice
+
+<TOC/>
 
 ## Por que Intlayer em vez de alternativas?
 
@@ -78,7 +86,7 @@ Definir o escopo do conteúdo do seu aplicativo **facilita a manutenção** de a
 
 <Accordion header="Agente de IA">
 
-A co-localização de conteúdo **reduz o contexto necessário** pelos Large Language Models (LLMs). O Intlayer também vem com um conjunto de ferramentas, como uma **CLI** para testar traduções ausentes,**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/mcp_server.md)**, e **[habilidades do agente](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/agent_skills.md)**, para tornar a experiência do desenvolvedor (DX) ainda mais tranquila para os agentes de IA.
+A co-localização de conteúdo **reduz o contexto necessário** pelos Large Language Models (LLMs). O Intlayer também vem com um conjunto de ferramentas, como uma **CLI** para testar traduções ausentes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/mcp_server.md)**, e **[habilidades do agente](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/agent_skills.md)**, para tornar a experiência do desenvolvedor (DX) ainda mais tranquila para os agentes de IA.
 
 </Accordion>
 
@@ -96,7 +104,7 @@ Conectar arquivos JSON enormes a componentes pode levar a problemas de desempenh
 
 <Accordion header="Escalonamento sem nenhum desenvolvedor">
 
-Mais do que apenas uma solução i18n, o Intlayer fornece um **[editor visual] auto-hospedado(https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md)** e um **[CMS completo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md)** para ajudá-lo a gerenciar seu conteúdo multilíngue em **tempo real**, facilitando a colaboração com tradutores, redatores e outros membros da equipe. O conteúdo pode ser armazenado local e/ou remotamente.
+Mais do que apenas uma solução i18n, o Intlayer fornece um **[editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md) auto-hospedado** e um **[CMS completo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md)** para ajudá-lo a gerenciar seu conteúdo multilíngue em **tempo real**, facilitando a colaboração com tradutores, redatores e outros membros da equipe. O conteúdo pode ser armazenado local e/ou remotamente.
 
 </Accordion>
 
@@ -109,52 +117,9 @@ Em vez de carregar arquivos JSON enormes em suas páginas, carregue apenas o con
 
 <Steps>
 
-<Step number={1} title="instalar dependências">
+<Step number={1} title="Instalar Dependências">
 
-Consulte [Modelo de aplicativo](https://github.com/aymericzip/intlayer-react-native-template) no GitHub.
-
-No seu projeto React Native, instale os seguintes pacotes:
-
-```bash packageManager="npm"
-npm instalar camada interna reagir-intlayer
-npm install --save-dev react-native-intlayer
-inicialização da camada interna npx
-```
-
-```bash packageManager="pnpm"
-pnpm adicionar camada interna reagir-intlayer
-pnpm add --save-dev react-native-intlayer
-inicialização da camada interna pnpm
-```
-
-```bash packageManager="yarn"
-fio adicionar camada interna reagir camada interna
-fio adicionar --save-dev reagir-nativo-intlayer
-inicialização da camada interna do fio
-```
-
-```bash packageManager="bun"
-bun adicionar camada interna reagir-intlayer
-bun add --dev react-native-intlayer
-bun x intlayer init
-```
-
-### Pacotes
-
-- **camada interna**  
-  O kit de ferramentas principal i18n para configuração, conteúdo de dicionário, geração de tipos e comandos CLI.
-
-- **react-intlayer**  
-  Integração React que fornece os provedores de contexto e ganchos React que você usará no React Native para obter e alternar localidades.
-
-- **react-native-intlayer**  
-  Integração React Native que fornece o plugin Metro para integração do Intlayer com o empacotador React Native.
-
----
-
-</Step>
-
-<Step number={2} title="Instalar Dependências">
+Consulte o [Modelo de Aplicativo](https://github.com/aymericzip/intlayer-react-native-template) no GitHub.
 
 No seu projeto React Native, instale os seguintes pacotes:
 
@@ -174,28 +139,24 @@ yarn dlx intlayer-cli init --interactive
 bunx intlayer-cli init --interactive
 ```
 
-> a flag `--interactive` é opcional. Use `intlayer-cli init` se você for um agente de IA.
+> 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 react-intlayer
-npm install --save-dev react-native-intlayer
+npm install intlayer react-native-intlayer
 ```
 
 ```bash packageManager="pnpm"
-pnpm add intlayer react-intlayer
-pnpm add --save-dev react-native-intlayer
+pnpm add intlayer react-native-intlayer
 ```
 
 ```bash packageManager="yarn"
-yarn add intlayer react-intlayer
-yarn add --save-dev react-native-intlayer
+yarn add intlayer react-native-intlayer
 ```
 
 ```bash packageManager="bun"
-bun add intlayer react-intlayer
-bun add --dev react-native-intlayer
+bun add intlayer react-native-intlayer
 ```
 
 ### Pacotes
@@ -203,17 +164,14 @@ bun add --dev react-native-intlayer
 - **intlayer**  
   O kit de ferramentas i18n principal para configuração, conteúdo do dicionário, geração de tipos e comandos CLI.
 
-- **react-intlayer**  
-  Integração React que fornece os provedores de contexto e hooks React que você usará no React Native para obter e trocar localidades.
-
 - **react-native-intlayer**  
-  Integração React Native que fornece o plugin Metro para integrar o Intlayer com o bundler do React Native.
+  Integração React Native que fornece os provedores de contexto e hooks React que você usará para obter e trocar localidades, os polyfills do React Native e o plugin Metro para integrar o Intlayer com o bundler do React Native. Reexporta tudo de `react-intlayer`, portanto você só precisa deste único pacote em um aplicativo React Native.
 
 ---
 
 </Step>
 
-<Step number={3} title="Criar uma Configuração Intlayer">
+<Step number={2} title="Criar uma Configuração Intlayer">
 
 Na raiz do seu projeto (ou em qualquer lugar conveniente), crie um arquivo de **configuração do Intlayer**. Pode ser algo assim:
 
@@ -247,7 +205,7 @@ Dentro desta configuração, você pode:
 
 </Step>
 
-<Step number={4} title="Adicione o plugin Metro">
+<Step number={3} title="Adicione o plugin Metro">
 
 Metro é um empacotador para React Native. É o empacotador padrão para projetos React Native criados com o comando `react-native init`. Para usar o Intlayer com o Metro, você precisa adicionar o plugin ao seu arquivo `metro.config.js`:
 
@@ -262,13 +220,18 @@ module.exports = (async () => {
 })();
 ```
 
+> Nota: `configMetroIntlayer` é uma função que retorna uma promise. Use `configMetroIntlayerSync` se quiser usá-la de forma síncrona ou evitar IIFE (Immediately Invoked Function Expression).
+> Nota: `configMetroIntlayerSync` não permite construir dicionários intlayer no início do servidor
+
 </Step>
 
-<Step number={5} title="Adicione o provedor Intlayer">
+<Step number={4} title="Adicione o provedor Intlayer">
+
+Para manter sincronizada a linguagem do usuário em toda a sua aplicação, você precisa envolver seu componente raiz com o componente `IntlayerProvider` do `react-native-intlayer`.
 
-Para manter sincronizada a linguagem do usuário em toda a sua aplicação, você precisa envolver seu componente raiz com o componente `IntlayerProvider` do `react-intlayer-native`.
+> Sempre importe de `react-native-intlayer`. Seu `IntlayerProvider` inclui polyfills para a API web usada pelo Intlayer, e o pacote reexporta todos os hooks e utilitários de `react-intlayer`.
 
-> Certifique-se de usar o provedor do `react-native-intlayer` em vez do `react-intlayer`. A exportação do `react-native-intlayer` inclui polyfills para a API web.
+Além disso, você precisa adicionar a função `intlayerPolyfill` ao seu arquivo `index.js` para garantir que o Intlayer funcione corretamente.
 
 ```tsx fileName="app/_layout.tsx" codeFormat={["typescript", "esm"]}
 import { Stack } from "expo-router";
@@ -293,7 +256,7 @@ export default RootLayout;
 
 </Step>
 
-<Step number={6} title="Declare Seu Conteúdo">
+<Step number={5} title="Declare Seu Conteúdo">
 
 Crie arquivos de **declaração de conteúdo** em qualquer lugar do seu projeto (comumente dentro de `src/`), usando qualquer um dos formatos de extensão que o Intlayer suporta:
 
@@ -364,7 +327,7 @@ export default homeScreenContent;
 
 </Step>
 
-<Step number={7} title="Use o Intlayer em Seus Componentes">
+<Step number={6} title="Use o Intlayer em Seus Componentes">
 
 Use o hook `useIntlayer` em componentes filhos para obter conteúdo localizado.
 
@@ -372,7 +335,7 @@ Use o hook `useIntlayer` em componentes filhos para obter conteúdo localizado.
 
 ```tsx fileName="app/(tabs)/index.tsx" codeFormat={["typescript", "esm"]}
 import { Image, StyleSheet, Platform } from "react-native";
-import { useIntlayer } from "intlayer";
+import { useIntlayer } from "react-native-intlayer";
 import { HelloWave } from "@/components/HelloWave";
 import ParallaxScrollView from "@/components/ParallaxScrollView";
 import { ThemedText } from "@/components/ThemedText";
@@ -419,7 +382,7 @@ export default HomeScreen;
 
 </Step>
 
-<Step number={8} title="Alterar o Locale do App" isOptional={true}>
+<Step number={7} title="Alterar o Locale do App" isOptional={true}>
 
 Para trocar os locales dentro dos seus componentes, você pode usar o método `setLocale` do hook `useLocale`:
 
@@ -427,7 +390,7 @@ Para trocar os locales dentro dos seus componentes, você pode usar o método `s
 import { type FC } from "react";
 import { View, Text, TouchableOpacity, StyleSheet } from "react-native";
 import { getLocaleName } from "intlayer";
-import { useLocale } from "react-intlayer";
+import { useLocale } from "react-native-intlayer";
 
 export const LocaleSwitcher: FC = () => {
   const { setLocale, availableLocales } = useLocale();
@@ -504,7 +467,7 @@ Isto é o que habilita funcionalidades como:
 Para evitar o commit de arquivos gerados automaticamente pelo Intlayer, adicione o seguinte ao seu `.gitignore`:
 
 ```bash
-#  Ignorar os arquivos gerados pelo Intlayer
+# Ignorar os arquivos gerados pelo Intlayer
 .intlayer
 ```
 
@@ -545,7 +508,7 @@ Intlayer tem como alvo principal a Web Intl API; no React Native você deve incl
 
 Checklist:
 
-- Use as últimas versões de `intlayer`, `react-intlayer` e `react-native-intlayer`.
+- Use as últimas versões de `intlayer` e `react-native-intlayer`.
 - Ative o polyfill do Intlayer.
 - Se você usar `getLocaleName` ou outros utilitários baseados em Intl-API, importe esses polyfills cedo (por exemplo em `index.js` ou `App.tsx`):