@intlayer/docs 8.11.1 → 8.11.3

package/docs/pl/interest_of_intlayer.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2024-08-14
-updatedAt: 2025-09-27
+updatedAt: 2026-05-31
 title: Zalety Intlayer
-description: Odkryj korzyści i zalety korzystania z Intlayer w swoich projektach. Dowiedz się, dlaczego Intlayer wyróżnia się na tle innych rozwiązań.
+description: Odkryj korzyści i zalety korzystania z Intlayer w swoich projektach. Zrozum, dlaczego Intlayer wyróżnia się na tle innych frameworków.
 keywords:
-  - Korzyści
   - Zalety
+  - Korzyści
   - Intlayer
   - Framework
   - Porównanie
@@ -13,6 +13,9 @@ slugs:
   - doc
   - why
 history:
+  - version: 8.11.2
+    date: 2026-05-31
+    changes: "Dodano sekcję Dlaczego Intlayer zamiast alternatyw"
   - version: 7.3.1
     date: 2025-11-27
     changes: "Wydanie Kompilatora"
@@ -28,13 +31,60 @@ history:
 
 ## Czym jest Intlayer?
 
-**Intlayer** to biblioteka do internacjonalizacji zaprojektowana specjalnie dla programistów JavaScript. Pozwala ona na deklarowanie treści w dowolnym miejscu w kodzie. Przekształca deklaracje treści wielojęzycznych w strukturalne słowniki, które można łatwo zintegrować z kodem. Dzięki zastosowaniu TypeScript, **Intlayer** sprawia, że proces programowania staje się bardziej solidny i wydajny.
+**Intlayer** to biblioteka umiędzynarodowienia (i18n) zaprojektowana specjalnie dla programistów JavaScript. Umożliwia ona deklarowanie treści w dowolnym miejscu w kodzie. Konwertuje deklaracje treści wielojęzycznych na strukturyzowane słowniki, które można łatwo zintegrować z kodem. Dzięki użyciu TypeScript, **Intlayer** czyni Twój proces programowania silniejszym i bardziej wydajnym.
+
+## Dlaczego Intlayer zamiast alternatyw?
+
+W porównaniu do głównych rozwiązań, takich jak `next-intl` czy `i18next`, Intlayer jest rozwiązaniem, które oferuje wbudowane optymalizacje, takie jak:
+
+<AccordionGroup>
+<Accordion header="Rozmiar paczki (Bundle size)">
+
+Zamiast ładować ogromne pliki JSON na swoje strony, ładuj tylko niezbędną treść. Intlayer pomaga **zmniejszyć rozmiar paczki i stron nawet o 50%**.
+
+</Accordion>
+<Accordion header="Łatwość konserwacji">
+
+Ograniczenie zakresu treści aplikacji do poziomu komponentów **ułatwia konserwację** w przypadku aplikacji na dużą skalę. Możesz zduplikować lub usunąć pojedynczy folder z funkcjonalnością bez obciążenia psychicznego związanego z przeglądaniem całego kodu treści. Dodatkowo Intlayer jest **w pełni typowany**, aby zapewnić dokładność Twoich treści.
+
+</Accordion>
+<Accordion header="Agent AI">
+
+Umieszczenie treści bezpośrednio przy komponentach (co-location) **zmniejsza kontekst** wymagany przez duże modele językowe (LLM). Intlayer jest również wyposażony w zestaw narzędzi, takich jak **CLI** do testowania brakujących tłumaczeń, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/mcp_server.md)** oraz **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/agent_skills.md)**, aby uczynić środowisko programistyczne (DX) jeszcze bardziej płynnym dla agentów AI.
+
+</Accordion>
+<Accordion header="Funkcje">
+
+Intlayer oferuje szereg dodatkowych funkcji, których inne rozwiązania i18n nie posiadają, takich jak [obsługa Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/markdown.md), [pobieranie treści zewnętrznych](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/function_fetching.md), [ładowanie treści z plików](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/file.md), [aktualizacja treści na żywo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/live.md), [wizualny edytor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md) i wiele więcej.
+
+</Accordion>
+<Accordion header="Automatyzacja">
+
+Skorzystaj z automatyzacji tłumaczeń w swoim rurociągu CI/CD, używając wybranego modelu LLM po kosztach bezpośrednich u Twojego dostawcy AI. Intlayer oferuje również **kompilator** do automatycznego wyodrębniania treści, a także [platformę internetową](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_CMS.md) wspierającą **tłumaczenie w tle**.
+
+</Accordion>
+<Accordion header="Wydajność">
+
+Podłączanie potężnych plików JSON do komponentów może prowadzić do problemów z wydajnością i reaktywnością. Intlayer optymalizuje ładowanie treści już na etapie budowania (build).
+
+</Accordion>
+<Accordion header="Współpraca z osobami nietechnicznymi">
+
+Intlayer to coś więcej niż tylko rozwiązanie i18n — udostępnia on **[wizualny edytor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md) z możliwością własnego hostowania** oraz **[pełny CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_CMS.md)**, który ułatwia zarządzanie wielojęzyczną treścią w **czasie rzeczywistym**. Dzięki temu współpraca z tłumaczami, copywriterami i innymi członkami zespołu jest bezproblemowa. Treści mogą być przechowywane lokalnie i/lub zdalnie.
+
+</Accordion>
+<Accordion header="Architektura wieloframeworkowa">
+
+Jeśli używasz różnych frameworków dla różnych części swojej aplikacji (np. React, React-native, Vue, Angular, Svelte itp.), Intlayer zapewnia sposób na **stosowanie wspólnej składni i implementacji we wszystkich głównych frameworkach frontendowych**. Będziesz także mógł udostępniać swoje deklaracje treści w swoim design systemie, aplikacjach, backendzie itd.
+
+</Accordion>
+</AccordionGroup>
 
 ## Dlaczego powstał Intlayer?
 
-Intlayer powstał, aby rozwiązać powszechny problem dotyczący wszystkich popularnych bibliotek i18n, takich jak `next-intl`, `react-i18next`, `react-intl`, `next-i18next`, `react-intl` czy `vue-i18n`.
+Intlayer powstał, aby rozwiązać powszechny problem dotykający wszystkie popularne biblioteki i18n, takie jak `next-intl`, `react-i18next`, `react-intl`, `next-i18next`, `react-intl` oraz `vue-i18n`.
 
-Wszystkie te rozwiązania stosują scentralizowane podejście do listowania i zarządzania treścią. Na przykład:
+Wszystkie te rozwiązania stosują scentralizowane podejście do listowania i zarządzania treściami. Na przykład:
 
 ```bash
 .
@@ -49,7 +99,7 @@ Wszystkie te rozwiązania stosują scentralizowane podejście do listowania i za
             └── index.tsx
 ```
 
-Lub przy użyciu przestrzeni nazw:
+Lub tutaj przy użyciu przestrzeni nazw (namespaces):
 
 ```bash
 .
@@ -72,21 +122,21 @@ Lub przy użyciu przestrzeni nazw:
 
 Tego typu architektura spowalnia proces programowania i komplikuje utrzymanie kodu z kilku powodów:
 
-1. **Dla każdego nowego komponentu należy:**
+1. **Dla każdego nowo tworzonego komponentu musisz:**
    - Utworzyć nowy zasób/przestrzeń nazw w folderze `locales`
-   - Pamiętać o zaimportowaniu nowej przestrzeni nazw na stronie
-   - Przetłumaczyć treść (często robione ręcznie poprzez kopiowanie/wklejanie z narzędzi AI)
+   - Pamiętać o zaimportowaniu nowej przestrzeni nazw na swojej stronie
+   - Przetłumaczyć treść (często robione ręcznie przez kopiowanie/wklejanie z narzędzi AI)
 
-2. **Dla każdej zmiany w komponentach należy:**
-   - Wyszukać powiązany zasób/przestrzeń nazw (z dala od komponentu)
+2. **Dla każdej zmiany wprowadzanej w komponentach musisz:**
+   - Wyszukać powiązany zasób/przestrzeń nazw (daleko od komponentu)
    - Przetłumaczyć treść
-   - Upewnić się, że treść jest aktualna dla wszystkich języków
+   - Upewnić się, że Twoja treść jest aktualna dla wszystkich języków (locales)
    - Zweryfikować, czy przestrzeń nazw nie zawiera nieużywanych kluczy/wartości
    - Upewnić się, że struktura plików JSON jest taka sama dla wszystkich języków
 
-W profesjonalnych projektach korzystających z tych rozwiązań często używa się platform lokalizacyjnych do zarządzania tłumaczeniami. Jednak w przypadku dużych projektów może to szybko stać się kosztowne.
+W profesjonalnych projektach korzystających z tych rozwiązań często stosuje się platformy lokalizacyjne, aby ułatwić zarządzanie tłumaczeniem treści. Może to jednak szybko stać się kosztowne w przypadku dużych projektów.
 
-Aby rozwiązać ten problem, Intlayer stosuje podejście polegające na ograniczeniu zakresu treści do każdego komponentu i przechowywaniu jej blisko niego, podobnie jak robimy to z CSS (`styled-components`), typami, dokumentacją (`storybook`) czy testami jednostkowymi (`jest`).
+Aby rozwiązać ten problem, Intlayer przyjmuje podejście, które ogranicza zakres treści do poziomu pojedynczego komponentu i trzyma treść blisko niego, podobnie jak często robimy to z CSS (`styled-components`), typami, dokumentacją (`storybook`) czy testami jednostkowymi (`jest`).
 
 ```bash codeFormat="typescript"
 .
@@ -147,82 +197,80 @@ export const ComponentExample = () => {
 
 Takie podejście pozwala na:
 
-1. **Zwiększenie prędkości programowania**
-   - Pliki `.content.{{ts|mjs|cjs|json}}` można tworzyć za pomocą rozszerzenia VSCode
-   - Narzędzia AI do autouzupełniania w IDE (np. GitHub Copilot) mogą pomagać w deklarowaniu treści, ograniczając kopiowanie/wklejanie
+1. **Zwiększenie szybkości programowania**
+   - Pliki `.content.{{ts|mjs|cjs|json}}` mogą być tworzone przy użyciu rozszerzenia VSCode
+   - Narzędzia do automatycznego uzupełniania AI w Twoim IDE (takie jak GitHub Copilot) mogą pomóc w deklarowaniu treści, ograniczając kopiowanie/wklejanie
 
-2. **Uporządkowanie kodu**
+2. **Uporządkowanie bazy kodu**
    - Zmniejszenie złożoności
-   - Zwiększenie łatwości utrzymania
+   - Zwiększenie łatwości konserwacji
 
-3. **Łatwiejsze duplikowanie komponentów wraz z ich treścią (np. komponenty logowania/rejestracji itp.)**
-   - Poprzez ograniczenie ryzyka wpływu na treść innych komponentów
-   - Poprzez kopiowanie/wklejanie treści z jednej aplikacji do drugiej bez zewnętrznych zależności
+3. **Łatwiejsze duplikowanie komponentów i powiązanych z nimi treści (np. komponenty logowania/rejestracji itp.)**
+   - Ograniczając ryzyko wpłynięcia na treść innych komponentów
+   - Kopiując i wklejając treść z jednej aplikacji do drugiej bez zewnętrznych zależności
 
-4. **Unikanie zaśmiecania kodu nieużywanymi kluczami/wartościami dla nieużywanych komponentów**
+4. **Unikanie zaśmiecania bazy kodu nieużywanymi kluczami/wartościami dla nieużywanych komponentów**
    - Jeśli nie używasz komponentu, Intlayer nie zaimportuje powiązanej z nim treści
-   - Jeśli usuniesz komponent, łatwiej będzie pamiętać o usunięciu powiązanej z nim treści, ponieważ znajduje się ona w tym samym folderze
+   - Jeśli usuniesz komponent, łatwiej zapamiętasz o usunięciu powiązanej treści, ponieważ będzie się ona znajdować w tym samym folderze
 
-5. **Zmniejszenie kosztów rozumowania dla agentów AI przy deklarowaniu treści wielojęzycznych**
-   - Agent AI nie będzie musiał skanować całego kodu, aby wiedzieć, gdzie zaimplementować treść
-   - Tłumaczenia można łatwo wykonać za pomocą narzędzi AI do autouzupełniania w IDE (np. GitHub Copilot)
+5. **Zmniejszenie kosztów wnioskowania dla agentów AI przy deklarowaniu treści wielojęzycznych**
+   - Agent AI nie będzie musiał skanować całej bazy kodu, aby dowiedzieć się, gdzie zaimplementować Twoją treść
+   - Tłumaczenia mogą być łatwo wykonywane przez narzędzia AI do automatycznego uzupełniania w Twoim IDE (takie jak GitHub Copilot)
 
 6. **Optymalizację wydajności ładowania**
-   - Jeśli komponent jest ładowany leniwie (lazy-loaded), powiązana z nim treść zostanie załadowana w tym samym czasie
+   - Jeśli komponent jest ładowany leniwie (lazy-loaded), powiązana z nim treść zostanie załadowana w tym samym momencie
 
 ## Dodatkowe funkcje Intlayer
 
-| Funkcja                                                                                                                   | Opis                                                                                                                                                                                                                                                                                                                                                                                                         |
-| ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| ![Funkcja](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                          | **Obsługa wielu frameworków**<br><br>Intlayer jest kompatybilny ze wszystkimi głównymi frameworkami i bibliotekami, w tym Next.js, React, Vite, Vue.js, Nuxt, Preact, Express i innymi.                                                                                                                                                                                                                      |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true)       | **Zarządzanie treścią oparte na JavaScript**<br><br>Wykorzystaj elastyczność JavaScript do wydajnego definiowania i zarządzania treścią. <br><br> - [Deklarowanie treści](https://intlayer.org/doc/concept/content)                                                                                                                                                                                          |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Funkcja" width="700">  | **Kompilator**<br><br>Kompilator Intlayer automatycznie wyodrębnia treść z komponentów i generuje pliki słowników.<br><br> - [Kompilator](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                                 |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **Plik deklaracji treści dla każdego języka**<br><br>Przyspiesz programowanie, deklarując treść raz przed automatycznym generowaniem.<br><br> - [Plik deklaracji treści dla każdego języka](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                      | **Środowisko bezpieczne pod względem typów (Type-Safe)**<br><br>Wykorzystaj TypeScript, aby upewnić się, że definicje treści i kod są wolne od błędów, korzystając jednocześnie z autouzupełniania w IDE.<br><br> - [Konfiguracja TypeScript](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                      |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                         | **Uproszczona konfiguracja**<br><br>Szybko rozpocznij pracę dzięki minimalnej konfiguracji. Łatwo dostosuj ustawienia internacjonalizacji, routingu, AI, budowania i obsługi treści. <br><br> - [Poznaj integrację z Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                   |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true)                   | **Uproszczone pobieranie treści**<br><br>Nie ma potrzeby wywoływania funkcji `t` dla każdego elementu treści. Pobieraj całą treść bezpośrednio za pomocą jednego hooka.<br><br> - [Integracja z React](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true)                    | **Spójna implementacja Server Components**<br><br>Idealnie dopasowana do Next.js Server Components, używaj tej samej implementacji dla komponentów klienckich i serwerowych, bez konieczności przekazywania funkcji `t` przez każdy komponent serwerowy. <br><br> - [Server Components](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                     |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true)                           | **Uporządkowany kod**<br><br>Utrzymuj kod w większym porządku: 1 komponent = 1 słownik w tym samym folderze. Tłumaczenia znajdujące się blisko swoich komponentów poprawiają łatwość utrzymania i przejrzystość. <br><br> - [Jak działa Intlayer](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                       |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true)                         | **Ulepszony routing**<br><br>Pełne wsparcie dla routingu aplikacji, płynnie dostosowujące się do złożonych struktur aplikacji w Next.js, React, Vite, Vue.js itd.<br><br> - [Poznaj integrację z Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                       |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true)                            | **Obsługa Markdown**<br><br>Importuj i interpretuj pliki lokalne oraz zdalne pliki Markdown dla treści wielojęzycznych, takich jak polityki prywatności, dokumentacja itp. Interpretuj i udostępniaj metadane Markdown w kodzie.<br><br> - [Pliki treści](https://intlayer.org/doc/concept/content/file)                                                                                                     |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true)                       | **Darmowy edytor wizualny i CMS**<br><br>Dla autorów treści dostępny jest darmowy edytor wizualny i CMS, eliminujący potrzebę korzystania z platform lokalizacyjnych. Synchronizuj treść za pomocą Git lub całkowicie lub częściowo wyprowadź ją na zewnątrz dzięki CMS.<br><br> - [Edytor Intlayer](https://intlayer.org/doc/concept/editor) <br> - [Intlayer CMS](https://intlayer.org/doc/concept/cms)    |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true)                              | **Treść typu Tree-shakable**<br><br>Treść typu tree-shakable, zmniejszająca rozmiar końcowego pakietu. Ładuje treść na poziomie komponentu, wykluczając wszelkie nieużywane treści z pakietu. Obsługuje leniwe ładowanie dla zwiększenia wydajności ładowania aplikacji. <br><br> - [Optymalizacja budowania aplikacji](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)          |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true)                    | **Renderowanie statyczne**<br><br>Nie blokuje renderowania statycznego. <br><br> - [Integracja z Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                       |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true)                      | **Tłumaczenie wspomagane przez AI**<br><br>Przetłumacz swoją stronę na 231 języków jednym kliknięciem, korzystając z zaawansowanych narzędzi tłumaczeniowych AI Intlayer z własnym dostawcą AI/kluczem API. <br><br> - [Integracja CI/CD](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [Auto-fill](https://intlayer.org/doc/concept/auto-fill) |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true)                                 | **Integracja z Serwerem MCP**<br><br>Zapewnia serwer MCP (Model Context Protocol) do automatyzacji IDE, umożliwiając płynne zarządzanie treścią i przepływy pracy i18n bezpośrednio w środowisku programistycznym. <br><br> - [Serwer MCP](https://github.com/aymericzip/intlayer/blob/main/docs/pl/mcp_server.md)                                                                                           |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true)                    | **Rozszerzenie VSCode**<br><br>Intlayer zapewnia rozszerzenie VSCode, które pomaga zarządzać treścią i tłumaczeniami, budować słowniki, tłumaczyć treści i nie tylko. <br><br> - [Rozszerzenie VSCode](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                           |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true)                    | **Interoperacyjność**<br><br>Umożliwia interoperacyjność z react-i18next, next-i18next, next-intl i react-intl. <br><br> - [Intlayer i react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer i next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer i next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next)                               |
-| Testowanie brakujących tłumaczeń (CLI/CI)                                                                                 | ✅ CLI: npx intlayer content test (audyt przyjazny dla CI)                                                                                                                                                                                                                                                                                                                                                   |
+| Funkcja                                                                                                                   | Opis                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                          | **Obsługa wielu frameworków**<br><br>Intlayer jest kompatybilny ze wszystkimi głównymi frameworkami i bibliotekami, w tym Next.js, React, Vite, Vue.js, Nuxt, Preact, Express i innymi.                                                                                                                                                                                                                                                                           |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true)       | **Zarządzanie treścią oparte na JavaScript**<br><br>Wykorzystaj elastyczność JavaScript do wydajnego definiowania i zarządzania treściami.<br><br> - [Deklaracja treści](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                                                                |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Feature" width="700">  | **Kompilator**<br><br>Kompilator Intlayer automatycznie wyodrębnia treść z komponentów i generuje pliki słowników.<br><br> - [Kompilator](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                                                                                      |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **Plik deklaracji treści dla konkretnego języka**<br><br>Przyspiesz proces tworzenia, deklarując treść raz, przed automatycznym generowaniem.<br><br> - [Plik deklaracji treści dla konkretnego języka](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                                         |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                      | **Środowisko bezpieczne pod kątem typów**<br><br>Skorzystaj z TypeScript, aby upewnić się, że definicje treści i kod są wolne od błędów, jednocześnie czerpiąc korzyści z autouzupełniania w IDE.<br><br> - [Konfiguracja TypeScript](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                   |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                         | **Uproszczona konfiguracja**<br><br>Szybko rozpocznij pracę przy minimalnej konfiguracji. Z łatwością dostosuj ustawienia lokalizacji, routingu, sztucznej inteligencji, budowania i obsługi treści. <br><br> - [Poznaj integrację z Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                        |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true)                   | **Uproszczone pobieranie treści**<br><br>Nie musisz wywoływać funkcji `t` dla każdego elementu treści. Pobierz całą zawartość bezpośrednio za pomocą jednego hooka.<br><br> - [Integracja z React](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                                                                         |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true)                    | **Spójna implementacja komponentów serwerowych**<br><br>Idealnie nadaje się do komponentów serwerowych Next.js, użyj tej samej implementacji dla komponentów klienckich i serwerowych, bez konieczności przekazywania funkcji `t` przez drzewo komponentów.<br><br> - [Komponenty serwerowe](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                                                     |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true)                           | **Uporządkowana baza kodu**<br><br>Utrzymuj bazę kodu w większym porządku: 1 komponent = 1 słownik w tym samym folderze. Tłumaczenia blisko powiązanych komponentów zwiększają łatwość konserwacji i przejrzystość. <br><br> - [Jak działa Intlayer](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                                         |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true)                         | **Ulepszony routing**<br><br>Pełna obsługa routingu aplikacji, płynnie dostosowująca się do złożonych struktur aplikacji dla Next.js, React, Vite, Vue.js itp.<br><br> - [Poznaj integrację z Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                               |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true)                            | **Obsługa Markdown**<br><br>Importuj i interpretuj pliki lokalne oraz zdalny Markdown dla treści wielojęzycznych, takich jak polityki prywatności, dokumentacja itp. Interpretuj i udostępniaj metadane Markdown w swoim kodzie.<br><br> - [Pliki treści](https://intlayer.org/doc/concept/content/file)                                                                                                                                                          |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true)                       | **Darmowy edytor wizualny i CMS**<br><br>Darmowy edytor wizualny i CMS są dostępne dla twórców treści, co eliminuje potrzebę korzystania z zewnętrznej platformy lokalizacyjnej. Utrzymuj synchronizację treści za pomocą Git lub całkowicie bądź częściowo przenieś zarządzanie do CMS.<br><br> - [Edytor Intlayer](https://intlayer.org/doc/concept/editor) <br> - [CMS Intlayer](https://intlayer.org/doc/concept/cms)                                         |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true)                              | **Zawartość podlegająca eliminacji nieużywanego kodu (Tree-shakable)**<br><br>Zawartość podlegająca tree-shakingowi, zmniejszająca rozmiar ostatecznej paczki. Ładuje treść dla poszczególnych komponentów, wykluczając nieużywane elementy z paczki. Obsługuje leniwe ładowanie w celu zwiększenia wydajności aplikacji. <br><br> - [Optymalizacja budowania aplikacji](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)              |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true)                    | **Renderowanie statyczne**<br><br>Nie blokuje renderowania statycznego.<br><br> - [Integracja z Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                                                                             |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true)                      | **Tłumaczenie wspomagane przez AI**<br><br>Przetłumacz swoją witrynę na 231 języków jednym kliknięciem, korzystając z zaawansowanych narzędzi tłumaczeniowych Intlayer opartych na sztucznej inteligencji, korzystając z własnego dostawcy AI/klucza API. <br><br> - [Integracja CI/CD](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [Autouzupełnianie](https://intlayer.org/doc/concept/auto-fill) |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true)                                 | **Integracja z serwerem MCP**<br><br>Udostępnia serwer MCP (Model Context Protocol) do automatyzacji IDE, umożliwiając bezproblemowe zarządzanie treścią i przepływy pracy i18n bezpośrednio w środowisku programistycznym. <br><br> - [Serwer MCP](https://github.com/aymericzip/intlayer/blob/main/docs/pl/mcp_server.md)                                                                                                                                       |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true)                    | **Rozszerzenie VSCode**<br><br>Intlayer udostępnia rozszerzenie do VSCode, które pomaga zarządzać treścią i tłumaczeniami, budować słowniki, tłumaczyć zawartość i nie tylko. <br><br> - [Rozszerzenie VSCode](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                                                                        |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true)                    | **Interoperacyjność**<br><br>Umożliwia interoperacyjność z react-i18next, next-i18next, next-intl i react-intl. <br><br> - [Intlayer i react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer i next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer i next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next)                                                                                    |
+| Testowanie brakujących tłumaczeń (CLI/CI)                                                                                 | ✅ CLI: npx intlayer content test (audyt przyjazny dla CI)                                                                                                                                                                                                                                                                                                                                                                                                        |
 
 ## Porównanie Intlayer z innymi rozwiązaniami
 
-| Cecha                                              | `intlayer`                                                                                                                | `react-i18next`                                                                                  | `react-intl` (FormatJS)                                                                                                   | `lingui`                                                        | `next-intl`                                                                                      | `next-i18next`                                                                                   | `vue-i18n`                                                           |
-| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------- |
-| **Tłumaczenia blisko komponentów**                 | ✅ Tak, treść znajduje się przy każdym komponencie                                                                        | ❌ Nie                                                                                           | ❌ Nie                                                                                                                    | ❌ Nie                                                          | ❌ Nie                                                                                           | ❌ Nie                                                                                           | ✅ Tak – przy użyciu `Single File Components` (SFCs)                 |
-| **Integracja z TypeScript**                        | ✅ Zaawansowana, automatycznie generowane ścisłe typy                                                                     | ⚠️ Podstawowa; wymaga dodatkowej konfiguracji dla pełnego bezpieczeństwa                         | ✅ Dobra, ale mniej ścisła                                                                                                | ⚠️ Typowanie wymaga konfiguracji                                | ✅ Dobra                                                                                         | ⚠️ Podstawowa                                                                                    | ✅ Dobra (typy dostępne; bezpieczeństwo kluczy wymaga konfiguracji)  |
-| **Wykrywanie brakujących tłumaczeń**               | ✅ Podświetlanie błędów TypeScript oraz błędy/ostrzeżenia w czasie budowania                                              | ⚠️ Głównie ciągi zapasowe (fallback) w czasie wykonywania                                        | ⚠️ Ciągi zapasowe                                                                                                         | ⚠️ Wymaga dodatkowej konfiguracji                               | ⚠️ Fallback w czasie wykonywania                                                                 | ⚠️ Fallback w czasie wykonywania                                                                 | ⚠️ Fallback/ostrzeżenia w czasie wykonywania (konfigurowalne)        |
-| **Bogata treść (JSX/Markdown/komponenty)**         | ✅ Bezpośrednie wsparcie                                                                                                  | ⚠️ Ograniczone / tylko interpolacja                                                              | ⚠️ Składnia ICU, brak prawdziwego JSX                                                                                     | ⚠️ Ograniczone                                                  | ❌ Nie zaprojektowane dla bogatych struktur                                                      | ⚠️ Ograniczone                                                                                   | ⚠️ Ograniczone (komponenty przez `<i18n-t>`, Markdown przez pluginy) |
-| **Tłumaczenie wspomagane przez AI**                | ✅ Tak, obsługuje wielu dostawców AI. Można używać z własnymi kluczami API. Uwzględnia kontekst aplikacji i zakres treści | ❌ Nie                                                                                           | ❌ Nie                                                                                                                    | ❌ Nie                                                          | ❌ Nie                                                                                           | ❌ Nie                                                                                           | ❌ Nie                                                               |
-| **Edytor wizualny**                                | ✅ Tak, lokalny edytor wizualny + opcjonalny CMS; możliwość wyprowadzenia treści kodu na zewnątrz; możliwość osadzenia    | ❌ Nie / dostępne przez zewnętrzne platformy lokalizacyjne                                       | ❌ Nie / dostępne przez zewnętrzne platformy lokalizacyjne                                                                | ❌ Nie / dostępne przez zewnętrzne platformy lokalizacyjne      | ❌ Nie / dostępne przez zewnętrzne platformy lokalizacyjne                                       | ❌ Nie / dostępne przez zewnętrzne platformy lokalizacyjne                                       | ❌ Nie / dostępne przez zewnętrzne platformy lokalizacyjne           |
-| **Zlokalizowany routing**                          | ✅ Tak, wsparcie dla zlokalizowanych ścieżek "z pudełka" (działa z Next.js i Vite)                                        | ⚠️ Brak wbudowanego, wymaga pluginów (np. `next-i18next`) lub własnej konfiguracji routera       | ❌ Nie, tylko formatowanie wiadomości, routing musi być ręczny                                                            | ⚠️ Brak wbudowanego, wymaga pluginów lub ręcznej konfiguracji   | ✅ Wbudowany, App Router obsługuje segment `[locale]`                                            | ✅ Wbudowany                                                                                     | ✅ Wbudowany                                                         |
-| **Dynamiczne generowanie ścieżek**                 | ✅ Tak                                                                                                                    | ⚠️ Plugin/ekosystem lub ręczna konfiguracja                                                      | ❌ Brak                                                                                                                   | ⚠️ Plugin/ręcznie                                               | ✅ Tak                                                                                           | ✅ Tak                                                                                           | ❌ Brak (zapewniane przez Nuxt i18n)                                 |
-| **Liczba mnoga**                                   | ✅ Wzorce oparte na wyliczeniach (enums)                                                                                  | ✅ Konfigurowalne (pluginy takie jak i18next-icu)                                                | ✅ (ICU)                                                                                                                  | ✅ (ICU/messageformat)                                          | ✅ Dobra                                                                                         | ✅ Dobra                                                                                         | ✅ Wbudowane reguły liczby mnogiej                                   |
-| **Formatowanie (daty, liczby, waluty)**            | ✅ Zoptymalizowane formatery (Intl pod spodem)                                                                            | ⚠️ Przez pluginy lub własne użycie Intl                                                          | ✅ Formatery ICU                                                                                                          | ✅ Helpery ICU/CLI                                              | ✅ Dobra (helpery Intl)                                                                          | ✅ Dobra (helpery Intl)                                                                          | ✅ Wbudowane formatery dat/liczb (Intl)                              |
-| **Format treści**                                  | ✅ .tsx, .ts, .js, .json, .md, .txt, (.yaml w trakcie prac)                                                               | ⚠️ .json                                                                                         | ✅ .json, .js                                                                                                             | ⚠️ .po, .json                                                   | ✅ .json, .js, .ts                                                                               | ⚠️ .json                                                                                         | ✅ .json, .js                                                        |
-| **Wsparcie ICU**                                   | ⚠️ W trakcie prac                                                                                                         | ⚠️ Przez plugin (i18next-icu)                                                                    | ✅ Tak                                                                                                                    | ✅ Tak                                                          | ✅ Tak                                                                                           | ⚠️ Przez plugin (`i18next-icu`)                                                                  | ⚠️ Przez własny formater/kompilator                                  |
-| **Helpery SEO (hreflang, sitemap)**                | ✅ Wbudowane narzędzia: helpery do sitemap, robots.txt, metadanych                                                        | ⚠️ Pluginy społeczności / ręcznie                                                                | ❌ Brak w rdzeniu                                                                                                         | ❌ Brak w rdzeniu                                               | ✅ Dobra                                                                                         | ✅ Dobra                                                                                         | ❌ Brak w rdzeniu (zapewniane przez Nuxt i18n)                       |
-| **Ekosystem / Społeczność**                        | ⚠️ Mniejszy, ale szybko rosnący i responsywny                                                                             | ✅ Największy i najbardziej dojrzały                                                             | ✅ Duży                                                                                                                   | ⚠️ Mniejszy                                                     | ✅ Średniej wielkości, skupiony na Next.js                                                       | ✅ Średniej wielkości, skupiony na Next.js                                                       | ✅ Duży w ekosystemie Vue                                            |
-| **Server-side Rendering i Server Components**      | ✅ Tak, zoptymalizowane pod kątem SSR / React Server Components                                                           | ⚠️ Obsługiwane na poziomie strony, ale wymaga przekazywania funkcji `t` w dół drzewa komponentów | ⚠️ Obsługiwane na poziomie strony z dodatkową konfiguracją, ale wymaga przekazywania funkcji `t` w dół drzewa komponentów | ✅ Obsługiwane, wymaga konfiguracji                             | ⚠️ Obsługiwane na poziomie strony, ale wymaga przekazywania funkcji `t` w dół drzewa komponentów | ⚠️ Obsługiwane na poziomie strony, ale wymaga przekazywania funkcji `t` w dół drzewa komponentów | ✅ Obsługiwane przez Nuxt/Vue SSR (brak RSC)                         |
-| **Tree-shaking (ładowanie tylko używanej treści)** | ✅ Tak, dla każdego komponentu w czasie budowania przez pluginy Babel/SWC                                                 | ⚠️ Zazwyczaj ładuje wszystko (można poprawić przez przestrzenie nazw / code-splitting)           | ⚠️ Zazwyczaj ładuje wszystko                                                                                              | ❌ Nie domyślnie                                                | ⚠️ Częściowo                                                                                     | ⚠️ Częściowo                                                                                     | ⚠️ Częściowo (z code-splitting / ręczną konfiguracją)                |
-| **Leniwe ładowanie (Lazy loading)**                | ✅ Tak, dla każdego języka / słownika                                                                                     | ✅ Tak (np. backendy/przestrzenie nazw na żądanie)                                               | ✅ Tak (dzielenie paczek językowych)                                                                                      | ✅ Tak (dynamiczny import katalogów)                            | ✅ Tak (na trasę / na język), wymaga zarządzania przestrzeniami nazw                             | ✅ Tak (na trasę / na język), wymaga zarządzania przestrzeniami nazw                             | ✅ Tak (asynchroniczne wiadomości językowe)                          |
-| **Usuwanie nieużywanej treści**                    | ✅ Tak, dla każdego słownika w czasie budowania                                                                           | ❌ Nie, tylko przez ręczne dzielenie przestrzeni nazw                                            | ❌ Nie, wszystkie zadeklarowane wiadomości są pakowane                                                                    | ✅ Tak, nieużywane klucze są wykrywane i usuwane przy budowaniu | ❌ Nie, wymaga ręcznego zarządzania przestrzeniami nazw                                          | ❌ Nie, wymaga ręcznego zarządzania przestrzeniami nazw                                          | ❌ Nie, możliwe tylko przez ręczne leniwe ładowanie                  |
-| **Zarządzanie dużymi projektami**                  | ✅ Zachęca do modułowości, odpowiednie dla systemów projektowych (design systems)                                         | ⚠️ Wymaga dużej dyscypliny w organizacji plików                                                  | ⚠️ Centralne katalogi mogą stać się bardzo duże                                                                           | ⚠️ Może stać się skomplikowane                                  | ✅ Modułowość dzięki konfiguracji                                                                | ✅ Modułowość dzięki konfiguracji                                                                | ✅ Modułowość dzięki konfiguracji Vue Router/Nuxt i18n               |
-
----
+| Cecha                                                      | `intlayer`                                                                                                                       | `react-i18next`                                                                                                                  | `react-intl` (FormatJS)                                                                                                                                   | `lingui`                                                                 | `next-intl`                                                                                                                      | `next-i18next`                                                                                                                   | `vue-i18n`                                                               |
+| ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| **Tłumaczenia blisko komponentów**                         | ✅ Tak, treść powiązana z każdym komponentem                                                                                     | ❌ Nie                                                                                                                           | ❌ Nie                                                                                                                                                    | ❌ Nie                                                                   | ❌ Nie                                                                                                                           | ❌ Nie                                                                                                                           | ✅ Tak — przy użyciu `Single File Components` (SFC)                      |
+| **Integracja z TypeScript**                                | ✅ Zaawansowane, automatycznie generowane ścisłe typy                                                                            | ⚠️ Podstawowa; dodatkowa konfiguracja dla bezpieczeństwa                                                                         | ✅ Dobra, ale mniej rygorystyczna                                                                                                                         | ⚠️ Typowanie wymaga konfiguracji                                         | ✅ Dobra                                                                                                                         | ⚠️ Podstawowa                                                                                                                    | ✅ Dobra (typy są dostępne; bezpieczeństwo kluczy wymaga konfiguracji)   |
+| **Wykrywanie brakujących tłumaczeń**                       | ✅ Wyróżnianie błędów w TypeScript oraz błąd/ostrzeżenie podczas budowania                                                       | ⚠️ Głównie ciągi rezerwowe (fallback) w czasie rzeczywistym                                                                      | ⚠️ Ciągi rezerwowe                                                                                                                                        | ⚠️ Wymaga dodatkowej konfiguracji                                        | ⚠️ Rezerwa w czasie rzeczywistym                                                                                                 | ⚠️ Rezerwa w czasie rzeczywistym                                                                                                 | ⚠️ Rezerwa/ostrzeżenia w czasie rzeczywistym (konfigurowalne)            |
+| **Bogata zawartość (JSX/Markdown/komponenty)**             | ✅ Bezpośrednie wsparcie                                                                                                         | ⚠️ Ograniczone / tylko interpolacja                                                                                              | ⚠️ Składnia ICU, nie rzeczywisty JSX                                                                                                                      | ⚠️ Ograniczone                                                           | ❌ Nie zaprojektowane dla złożonych węzłów                                                                                       | ⚠️ Ograniczone                                                                                                                   | ⚠️ Ograniczone (komponenty przez `<i18n-t>`, Markdown przez wtyczki)     |
+| **Tłumaczenie wspomagane przez AI**                        | ✅ Tak, obsługuje wielu dostawców AI. Możliwość korzystania z własnych kluczy API. Uwzględnia kontekst aplikacji i zakres treści | ❌ Nie                                                                                                                           | ❌ Nie                                                                                                                                                    | ❌ Nie                                                                   | ❌ Nie                                                                                                                           | ❌ Nie                                                                                                                           | ❌ Nie                                                                   |
+| **Edytor wizualny**                                        | ✅ Tak, lokalny edytor wizualny + opcjonalny CMS; możliwość wyeksportowania treści bazy kodu; osadzalny                          | ❌ Nie / dostępne za pośrednictwem zewnętrznych platform lokalizacyjnych                                                         | ❌ Nie / dostępne za pośrednictwem zewnętrznych platform lokalizacyjnych                                                                                  | ❌ Nie / dostępne za pośrednictwem zewnętrznych platform lokalizacyjnych | ❌ Nie / dostępne za pośrednictwem zewnętrznych platform lokalizacyjnych                                                         | ❌ Nie / dostępne za pośrednictwem zewnętrznych platform lokalizacyjnych                                                         | ❌ Nie / dostępne za pośrednictwem zewnętrznych platform lokalizacyjnych |
+| **Zlokalizowany routing**                                  | ✅ Tak, obsługuje zlokalizowane ścieżki od samego początku (działa z Next.js i Vite)                                             | ⚠️ Brak wbudowanego wsparcia, wymaga wtyczek (np. `next-i18next`) lub niestandardowej konfiguracji routera                       | ❌ Nie, tylko formatowanie komunikatów, routing musi być ręczny                                                                                           | ⚠️ Brak wbudowanego wsparcia, wymaga wtyczek lub konfiguracji ręcznej    | ✅ Wbudowany, App Router obsługuje segment `[locale]`                                                                            | ✅ Wbudowany                                                                                                                     | ✅ Wbudowany                                                             |
+| **Dynamiczne generowanie tras**                            | ✅ Tak                                                                                                                           | ⚠️ Wtyczka/ekosystem lub konfiguracja ręczna                                                                                     | ❌ Nie dostarczono                                                                                                                                        | ⚠️ Wtyczka/ręcznie                                                       | ✅ Tak                                                                                                                           | ✅ Tak                                                                                                                           | ❌ Nie dostarczono (Nuxt i18n udostępnia)                                |
+| **Pluralizacja**                                           | ✅ Wzorce oparte na wyliczeniach                                                                                                 | ✅ Konfigurowalne (wtyczki takie jak i18next-icu)                                                                                | ✅ (ICU)                                                                                                                                                  | ✅ (ICU/messageformat)                                                   | ✅ Dobra                                                                                                                         | ✅ Dobra                                                                                                                         | ✅ Wbudowane reguły liczby mnogiej                                       |
+| **Formatowanie (daty, liczby, waluty)**                    | ✅ Zoptymalizowane formatowania (Intl pod maską)                                                                                 | ⚠️ Za pomocą wtyczek lub niestandardowego użycia Intl                                                                            | ✅ Formatowania ICU                                                                                                                                       | ✅ Pomocnicy ICU/CLI                                                     | ✅ Dobra (pomocnicy Intl)                                                                                                        | ✅ Dobra (pomocnicy Intl)                                                                                                        | ✅ Wbudowane formatowania daty/liczby (Intl)                             |
+| **Format zawartości**                                      | ✅ .tsx, .ts, .js, .json, .md, .txt, (.yaml w trakcie opracowywania)                                                             | ⚠️ .json                                                                                                                         | ✅ .json, .js                                                                                                                                             | ⚠️ .po, .json                                                            | ✅ .json, .js, .ts                                                                                                               | ⚠️ .json                                                                                                                         | ✅ .json, .js                                                            |
+| **Obsługa ICU**                                            | ⚠️ WIP                                                                                                                           | ⚠️ Za pomocą wtyczki (i18next-icu)                                                                                               | ✅ Tak                                                                                                                                                    | ✅ Tak                                                                   | ✅ Tak                                                                                                                           | ⚠️ Za pomocą wtyczki (`i18next-icu`)                                                                                             | ⚠️ Za pomocą niestandardowego formatowania/kompilatora                   |
+| **Pomocnicy SEO (hreflang, sitemap)**                      | ✅ Wbudowane narzędzia: pomocnicy dla sitemap, robots.txt, metadanych                                                            | ⚠️ Wtyczki społeczności/ręcznie                                                                                                  | ❌ Nie jest rdzeniem                                                                                                                                      | ❌ Nie jest rdzeniem                                                     | ✅ Dobra                                                                                                                         | ✅ Dobra                                                                                                                         | ❌ Nie jest rdzeniem (Nuxt i18n udostępnia pomocników)                   |
+| **Ekosystem / Społeczność**                                | ⚠️ Mniejsza, ale szybko rosnąca i bardzo responsywna                                                                             | ✅ Największa i dojrzała                                                                                                         | ✅ Duża                                                                                                                                                   | ⚠️ Mniejsza                                                              | ✅ Średniej wielkości, skupiona na Next.js                                                                                       | ✅ Średniej wielkości, skupiona na Next.js                                                                                       | ✅ Duża w ekosystemie Vue                                                |
+| **Renderowanie po stronie serwera i komponenty serwerowe** | ✅ Tak, zoptymalizowane pod kątem SSR / React Server Components                                                                  | ⚠️ Obsługiwane na poziomie strony, ale wymaga przekazania funkcji t w drzewie komponentów do podrzędnych komponentów serwerowych | ⚠️ Obsługiwane na poziomie strony z dodatkową konfiguracją, ale wymaga przekazania funkcji t w drzewie komponentów do podrzędnych komponentów serwerowych | ✅ Obsługiwane, wymagana konfiguracja                                    | ⚠️ Obsługiwane na poziomie strony, ale wymaga przekazania funkcji t w drzewie komponentów do podrzędnych komponentów serwerowych | ⚠️ Obsługiwane na poziomie strony, ale wymaga przekazania funkcji t w drzewie komponentów do podrzędnych komponentów serwerowych | ✅ SSR przez Nuxt/Vue SSR (brak RSC)                                     |
+| **Tree-shaking (ładowanie tylko używanych treści)**        | ✅ Tak, na poziomie komponentu podczas budowania za pomocą wtyczek Babel/SWC                                                     | ⚠️ Zazwyczaj ładuje wszystko (można poprawić za pomocą przestrzeni nazw/dzielenia kodu)                                          | ⚠️ Zazwyczaj ładuje wszystko                                                                                                                              | ❌ Nie jest domyślne                                                     | ⚠️ Częściowy                                                                                                                     | ⚠️ Częściowy                                                                                                                     | ⚠️ Częściowy (z dzieleniem kodu/konfiguracją ręczną)                     |
+| **Leniwe ładowanie (Lazy loading)**                        | ✅ Tak, na język / na słownik                                                                                                    | ✅ Tak (np. backendy/namespaces na żądanie)                                                                                      | ✅ Tak (dzielone paczki językowe)                                                                                                                         | ✅ Tak (dynamiczne importowanie katalogów)                               | ✅ Tak (na trasę/na język), wymaga zarządzania przestrzeniami nazw                                                               | ✅ Tak (na trasę/na język), wymaga zarządzania przestrzeniami nazw                                                               | ✅ Tak (asynchroniczne wiadomości językowe)                              |
+| **Usuwanie nieużywanych treści**                           | ✅ Tak, na słownik podczas budowania                                                                                             | ❌ Nie, tylko poprzez ręczną segmentację przestrzeni nazw                                                                        | ❌ Nie, wszystkie zadeklarowane wiadomości są pakowane                                                                                                    | ✅ Tak, nieużywane klucze są wykrywane i usuwane podczas budowania       | ❌ Nie, można zarządzać ręcznie za pomocą przestrzeni nazw                                                                       | ❌ Nie, można zarządzać ręcznie za pomocą przestrzeni nazw                                                                       | ❌ Nie, możliwe tylko poprzez ręczne leniwe ładowanie                    |
+| **Zarządzanie dużymi projektami**                          | ✅ Wspiera modułowość, doskonałe dla systemów projektowych                                                                       | ⚠️ Wymaga dobrej dyscypliny w plikach                                                                                            | ⚠️ Centralne katalogi mogą stać się duże                                                                                                                  | ⚠️ Może stać się złożone                                                 | ✅ Modułowe z konfiguracją                                                                                                       | ✅ Modułowe z konfiguracją                                                                                                       | ✅ Modułowe z konfiguracją Vue Router/Nuxt i18n                          |
 
 ## Gwiazdki na GitHubie
 
-Gwiazdki na GitHubie są silnym wskaźnikiem popularności projektu, zaufania społeczności i długoterminowego znaczenia. Choć nie są bezpośrednią miarą jakości technicznej, odzwierciedlają, ilu programistów uważa projekt za przydatny, śledzi jego postępy i prawdopodobnie go przyjmie. Przy szacowaniu wartości projektu gwiazdki pomagają porównać zainteresowanie alternatywami i dostarczają wglądu w rozwój ekosystemu.
+Gwiazdki na GitHubie są silnym wskaźnikiem popularności projektu, zaufania społeczności i długoterminowej trajektorii. Choć nie są bezpośrednią miarą jakości technicznej, odzwierciedlają liczbę programistów, którzy uważają projekt za przydatny, śledzą jego postępy i prawdopodobnie go wdrożą. Do szacowania wartości projektu gwiazdki pomagają porównać atrakcyjność alternatyw i dostarczają wglądu w rozwój ekosystemu.
 
 [![Star History Chart](https://api.star-history.com/chart?repos=aymericzip/intlayer%2Cformatjs/formatjs%2Ci18next/react-i18next%2Ci18next/i18next%2Ci18next/next-i18next%2Clingui/js-lingui%2Camannn/next-intl%2Cintlify/vue-i18n%2Ccodingcommons/typesafe-i18n%2Copral/paraglide-js&type=date&legend=top-left)](https://www.star-history.com/#aymericzip/intlayer&formatjs/formatjs&i18next/react-i18next&i18next/i18next&i18next/next-i18next&lingui/js-lingui&amannn/next-intl&intlify/vue-i18n&codingcommons/typesafe-i18n&opral/paraglide-js)
 
@@ -230,6 +278,6 @@ Gwiazdki na GitHubie są silnym wskaźnikiem popularności projektu, zaufania sp
 
 ## Interoperacyjność
 
-`intlayer` może również pomóc w zarządzaniu przestrzeniami nazw `react-intl`, `react-i18next`, `next-intl`, `next-i18next` oraz `vue-i18n`.
+`intlayer` może również pomóc w zarządzaniu przestrzeniami nazw `react-intl`, `react-i18next`, `next-intl`, `next-i18next` i `vue-i18n`.
 
-Korzystając z `intlayer`, możesz zadeklarować swoją treść w formacie ulubionej biblioteki i18n, a intlayer wygeneruje przestrzenie nazw w wybranej przez Ciebie lokalizacji (przykład: `/messages/{{locale}}/{{namespace}}.json`).
+Używając `intlayer`, możesz zadeklarować treść w formacie swojej ulubionej biblioteki i18n, a intlayer wygeneruje przestrzenie nazw w wybranej przez Ciebie lokalizacji (przykład: `/messages/{{locale}}/{{namespace}}.json`).

package/docs/pl/intlayer_CMS.md

@@ -380,7 +380,7 @@ Uwagi i ograniczenia:
 - Dodaj pochodzenie live sync do polityki bezpieczeństwa swojej strony (CSP). Upewnij się, że adres URL live sync jest dozwolony w `connect-src` (oraz `frame-ancestors`, jeśli ma to zastosowanie).
 - Live Sync nie działa ze statycznym outputem. W Next.js strona musi być dynamiczna, aby otrzymywać aktualizacje w czasie wykonywania (np. użyj `generateStaticParams`, `generateMetadata`, `getServerSideProps` lub `getStaticProps` odpowiednio, aby uniknąć pełnych ograniczeń statycznych).
 - W CMS każdy słownik ma flagę `live`. Tylko słowniki z `live=true` są pobierane przez API live sync; pozostałe są importowane dynamicznie i pozostają niezmienione w czasie wykonywania.
-- Flaga `live` jest oceniana dla każdego słownika podczas budowania. Jeśli zdalna zawartość nie była oznaczona jako `live=true` podczas budowania, musisz przebudować projekt, aby włączyć Live Sync dla tego słownika.
+- Flaga `live` jest oceniana dla każdego słownika podczas budowania (build time). Jeśli zdalna zawartość nie była oznaczona jako `live=true` podczas budowania (build time), musisz przebudować projekt, aby włączyć Live Sync dla tego słownika.
 - Serwer live sync musi mieć możliwość zapisu do `.intlayer`. W kontenerach upewnij się, że masz dostęp do zapisu do `/.intlayer`.
 
 ## Debug

package/docs/pl/intlayer_with_adonisjs.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2026-05-06
-title: AdonisJS i18n - Jak przetłumaczyć aplikację AdonisJS w 2026
-description: Dowiedz się, jak uczynić swój backend AdonisJS wielojęzycznym. Postępuj zgodnie z dokumentacją, aby go umiędzynarodowić (i18n) i przetłumaczyć.
+updatedAt: 2026-05-31
+title: AdonisJS i18n - Kompletny przewodnik po tłumaczeniu AdonisJS
+description: Najlepsze rozwiązanie dla rozmiaru bundle, SEO, wydajności & utrzymania. Uczyń swój AdonisJS backend wielojęzycznym w 2026, tłumaczenie LLM, Agent Skills & MCP.
 keywords:
   - Międzynarodowienie
   - Dokumentacja

package/docs/pl/intlayer_with_analog.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-05-06
-title: Analog i18n - Jak przetłumaczyć aplikację Analog w 2026
-description: Dowiedz się, jak uczynić swoją aplikację Analog wielojęzyczną. Postępuj zgodnie z dokumentacją, aby przeprowadzić internacjonalizację (i18n) i tłumaczenie.
+updatedAt: 2026-05-31
+title: Analog i18n - Kompletny przewodnik po tłumaczeniu Analog
+description: Najlepsze rozwiązanie dla rozmiaru bundle, SEO, wydajności & utrzymania. Uczyń swój Analog aplikację wielojęzycznym w 2026, tłumaczenie LLM, Agent Skills & MCP.
 keywords:
   - Internacjonalizacja
   - Dokumentacja
@@ -56,16 +56,37 @@ history:
 
 <TOC/>
 
-## Czym jest Intlayer?
+## Dlaczego Interlayer zamiast alternatyw?
 
-**Intlayer** to innowacyjna biblioteka internacjonalizacji (i18n) typu open-source, zaprojektowana w celu uproszczenia obsługi wielojęzyczności w nowoczesnych aplikacjach internetowych.
+W porównaniu do głównych rozwiązań, takich jak `ngx-translate` czy `angular-l10n`, Intlayer jest rozwiązaniem wyposażonym w zintegrowane optymalizacje, takie jak:
 
-Z Intlayer możesz:
+**Pełne pokrycie analogowe**
 
-- **Łatwo zarządzać tłumaczeniami** za pomocą deklaratywnych słowników na poziomie komponentów.
-- **Dynamicznie lokalizować metadane**, trasy i treści.
-- **Zapewnić wsparcie TypeScript** dzięki automatycznie generowanym typom, poprawiając autouzupełnianie i wykrywanie błędów.
-- **Korzystać z zaawansowanych funkcji**, takich jak dynamiczne wykrywanie i przełączanie języka (locale).
+Intlayer jest zoptymalizowany do doskonałej współpracy z Analogiem, oferując **wielojęzyczny routing**, **obsługę SSR** i wszystkie funkcje potrzebne do skalowania internacjonalizacji (i18n).
+
+**Rozmiar bundle'a**
+
+Zamiast ładować ogromne pliki JSON na swoje strony, ładuj tylko niezbędną treść. Intlayer pomaga **zmniejszyć rozmiary bundle'a i stron nawet o 50%**.
+
+**Ł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 Inlayer jest **w pełni napisany**, aby zapewnić dokładność treści.
+
+**Agent AI**
+
+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.
+
+**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**.
+
+**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.
+
+**Skalowanie bez użycia dewelopera**
+
+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.
 
 ---
 
@@ -73,7 +94,9 @@ Z Intlayer możesz:
 
 Zobacz [Szablon aplikacji](https://github.com/aymericzip/intlayer-analog-template) na GitHubie.
 
-### Krok 1: Instalacja zależności
+<Steps>
+
+<Step number={1} title="Instalacja zależności">
 
 Zainstaluj niezbędne pakiety za pomocą npm:
 
@@ -107,7 +130,9 @@ bun x intlayer init
 - **vite-intlayer**
   Pakiet integrujący Intlayer z Vite. Dostarcza wtyczkę (plugin) do obsługi plików deklaracji treści i ustawia aliasy dla optymalnej wydajności.
 
-### Krok 2: Konfiguracja projektu
+</Step>
+
+<Step number={2} title="Konfiguracja projektu">
 
 Utwórz plik konfiguracyjny, aby skonfigurować języki swojej aplikacji:
 
@@ -131,7 +156,9 @@ export default config;
 
 > Za pomocą tego pliku konfiguracyjnego możesz ustawić zlokalizowane adresy URL, przekierowania middleware, nazwy ciasteczek, lokalizację i rozszerzenie deklaracji treści, wyłączyć logi Intlayer w konsoli i wiele więcej. Pełną listę dostępnych parametrów znajdziesz w [dokumentacji konfiguracji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md).
 
-### Krok 3: Zintegruj Intlayer w konfiguracji Vite
+</Step>
+
+<Step number={3} title="Zintegruj Intlayer w konfiguracji Vite">
 
 Aby zintegrować Intlayer z Analog, musisz użyć wtyczki `vite-intlayer`.
 
@@ -153,7 +180,9 @@ export default defineConfig(() => ({
 
 > Wtyczka `intlayer()` konfiguruje Vite do pracy z Intlayer. Obsługuje pliki deklaracji treści i ustawia aliasy dla optymalnej wydajności.
 
-### Krok 4: Zadeklaruj swoją treść
+</Step>
+
+<Step number={4} title="Zadeklaruj swoją treść">
 
 Twórz i zarządzaj deklaracjami treści, aby przechowywać tłumaczenia:
 
@@ -185,7 +214,9 @@ export default appContent;
 
 > Więcej szczegółów znajdziesz w [dokumentacji deklaracji treści](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/content_file.md).
 
-### Krok 5: Użyj Intlayer w kodzie
+</Step>
+
+<Step number={5} title="Użyj Intlayer w kodzie">
 
 Aby korzystać z funkcji internacjonalizacji Intlayer w całej aplikacji Analog, musisz dodać Intlayer do konfiguracji aplikacji.
 
@@ -223,7 +254,9 @@ export default class HomeComponent {
 
 Treść Intlayer jest zwracana jako `Signal`, więc dostęp do wartości uzyskujesz wywołując sygnał: `content().title`.
 
-### (Opcjonalnie) Krok 6: Zmiana języka treści
+</Step>
+
+<Step number={6} title="Zmiana języka treści" isOptional={true}>
 
 Aby zmienić język treści, możesz użyć funkcji `setLocale` dostarczonej przez funkcję `useLocale`. Pozwala to ustawić język aplikacji i odpowiednio zaktualizować treść.
 
@@ -335,3 +368,7 @@ Więcej szczegółów na temat korzystania z rozszerzenia znajdziesz w [dokument
 ### Dowiedz się więcej
 
 Aby pójść dalej, możesz zaimplementować [edytor wizualny](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md) lub wyeksportować treść do zewnętrznego systemu za pomocą [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_CMS.md).
+
+</Step>
+
+</Steps>