@intlayer/docs 8.11.2 → 8.11.3

package/docs/it/intlayer_with_astro_svelte.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-24
-updatedAt: 2026-05-06
-title: Astro + Svelte i18n - Come tradurre un'applicazione Astro + Svelte nel 2026
-description: Scopri come aggiungere l'internazionalizzazione (i18n) al tuo sito Astro + Svelte con Intlayer. Segui questa guida per rendere il tuo sito multilingue.
+updatedAt: 2026-05-31
+title: Astro + Svelte i18n - Guida completa per tradurre Astro + Svelte
+description: La migliore soluzione per dimensione del bundle, SEO, prestazioni & manutenibilità. Rendi il tuo Astro and Svelte sito web multilingue nel 2026, traduzione LLM, Agent Skills & MCP.
 keywords:
   - internazionalizzazione
   - documentazione
@@ -58,16 +58,47 @@ history:
 
 <TOC/>
 
-## Cos'è Intlayer?
+## Perché Intlayer rispetto alle alternative?
 
-**Intlayer** è una libreria di internazionalizzazione (i18n) innovativa e open-source progettata per semplificare il supporto multilingue nelle moderne applicazioni web.
+Rispetto alle soluzioni principali come `astro-i18n` o `i18next`, Intlayer è una soluzione dotata di ottimizzazioni integrate come:
 
-Con Intlayer puoi:
+<AccordionGroup>
+<Accordion header="Copertura Astro completa">
 
-- **Gestire le traduzioni facilmente**: Utilizzando dizionari dichiarativi a livello di componente.
-- **Localizzare metadati, percorsi e contenuti dinamicamente**.
-- **Garantire il supporto TypeScript**: Con tipi autogenerati per migliorare l'autocompletamento e il rilevamento degli errori.
-- **Beneficiare di funzioni avanzate**: Come il rilevamento dinamico della lingua e il cambio di lingua.
+Intlayer è ottimizzato per funzionare perfettamente con Astro offrendo **routing multilingue**, **mappa del sito** e tutte le funzionalità necessarie per scalare l'internazionalizzazione (i18n).
+
+</Accordion>
+<Accordion header="Dimensione del bundle">
+
+Invece di caricare enormi file JSON nelle tue pagine, carica solo il contenuto necessario. Intlayer aiuta a **ridurre le dimensioni del bundle e della pagina fino al 50%**.
+
+</Accordion>
+<Accordion header="Manutenibilità">
+
+L'ambito del contenuto dell'applicazione **facilita la manutenzione** per applicazioni su larga scala. Puoi duplicare o eliminare una singola cartella di funzionalità senza l'onere mentale di rivedere l'intera codebase dei contenuti. Inoltre, Intlayer è **completamente tipizzato (fully typed)** per garantire l'accuratezza dei tuoi contenuti.
+
+</Accordion>
+<Accordion header="Agente IA">
+
+La co-localizzazione dei contenuti **riduce il contesto necessario** dai Large Language Models (LLM). Intlayer viene fornito anche con una suite di strumenti, come una **CLI** per verificare le traduzioni mancanti,**[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)** e **[capacità dell'agente](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**, per rendere l'esperienza dello sviluppatore (DX) ancora più fluida per gli agenti IA.
+
+</Accordion>
+<Accordion header="Automazione">
+
+Utilizza l'automazione per tradurre nella tua pipeline CI/CD utilizzando il LLM di tua scelta al costo del tuo provider di intelligenza artificiale. Intlayer offre anche un **compilatore** per automatizzare l'estrazione dei contenuti, nonché una [piattaforma web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md) per aiutare a **tradurre in background**.
+
+</Accordion>
+<Accordion header="Prestazione">
+
+La connessione di enormi file JSON ai componenti può portare a problemi di prestazioni e reattività. Intlayer ottimizza il caricamento dei contenuti in fase di compilazione.
+
+</Accordion>
+<Accordion header="Scalabilità con nessuno sviluppatore">
+
+Più di una semplice soluzione i18n, Intlayer fornisce un **[editor visivo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** self-hosted e un **[CMS completo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)** per aiutarti gestisci i tuoi contenuti multilingue in **tempo reale**, semplificando la collaborazione con traduttori, copywriter e altri membri del team. I contenuti possono essere archiviati localmente e/o in remoto.
+
+</Accordion>
+</AccordionGroup>
 
 ---
 
@@ -75,7 +106,9 @@ Con Intlayer puoi:
 
 Controlla il [template dell'applicazione](https://github.com/aymericzip/intlayer-astro-template) su GitHub.
 
-### Passaggio 1: Installare le dipendenze
+<Steps>
+
+<Step number={1} title="Installare le dipendenze">
 
 Installa i pacchetti necessari utilizzando il tuo gestore di pacchetti preferito:
 
@@ -118,7 +151,9 @@ bun x intlayer init
 - **@astrojs/svelte**
   Integrazione ufficiale di Astro che consente l'uso di islands di componenti Svelte.
 
-### Passaggio 2: Configura il tuo progetto
+</Step>
+
+<Step number={2} title="Configura il tuo progetto">
 
 Crea un file di configurazione per definire le lingue della tua applicazione:
 
@@ -143,7 +178,9 @@ export default config;
 
 > Attraverso questo file di configurazione, puoi configurare URL localizzati, reindirizzamenti del middleware, nomi dei cookie, posizione ed estensioni delle dichiarazioni di contenuto, disabilitare i log di Intlayer nella console e altro ancora. Per un elenco completo dei parametri disponibili, consulta la [documentazione di configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md).
 
-### Passaggio 3: Integra Intlayer nella tua configurazione Astro
+</Step>
+
+<Step number={3} title="Integra Intlayer nella tua configurazione Astro">
 
 Aggiungi il plugin `intlayer` e l'integrazione Svelte alla tua configurazione Astro.
 
@@ -164,7 +201,9 @@ export default defineConfig({
 
 > L'integrazione `svelte()` consente di utilizzare islands di componenti Svelte tramite `client:only="svelte"`.
 
-### Passaggio 4: Dichiara i tuoi contenuti
+</Step>
+
+<Step number={4} title="Dichiara i tuoi contenuti">
 
 Crea e gestisci le tue dichiarazioni di contenuto per memorizzare le traduzioni:
 
@@ -190,7 +229,9 @@ export default appContent;
 
 > Per ulteriori informazioni, consulta la [documentazione sulla dichiarazione del contenuto](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/content_file.md).
 
-### Passaggio 5: Utilizzare il contenuto in Astro
+</Step>
+
+<Step number={5} title="Utilizzare il contenuto in Astro">
 
 Puoi consumare i dizionari direttamente nei tuoi file `.astro` utilizzando gli helper core esportati da `intlayer`. Dovresti anche aggiungere metadati SEO (come hreflang e link canonici) a ogni pagina e introdurre una Svelte island per i contenuti interattivi lato client.
 
@@ -278,7 +319,9 @@ const { title } = getIntlayer("app", locale);
 > - **`prefix-all`:** tutti gli URL hanno il prefisso della lingua. Puoi usare lo standard `[locale]` se non hai bisogno di gestire la radice separatamente.
 > - **`search-param` o `no-prefix`:** non sono necessarie directory per la lingua. La lingua viene gestita tramite parametri di query o cookie.
 
-### Passaggio 6: Crea un componente Svelte Island
+</Step>
+
+<Step number={6} title="Crea un componente Svelte Island">
 
 Crea un componente island che racchiuda la tua applicazione Svelte. Devi chiamare `setupIntlayer` con la lingua rilevata dal server prima di accedere agli store.
 
@@ -323,7 +366,9 @@ Crea un componente island che racchiuda la tua applicazione Svelte. Devi chiamar
 
 > La prop `locale` viene passata dalla pagina Astro (rilevamento lato server) e utilizzata per inizializzare `setupIntlayer`, impostando la lingua iniziale per tutti gli store nel componente.
 
-### Passaggio 7: Aggiungi un selettore di lingua
+</Step>
+
+<Step number={7} title="Aggiungi un selettore di lingua">
 
 La funzionalità di cambio lingua è integrata direttamente all'interno della Svelte island (vedi passaggio 6 sopra). Utilizza lo store `useLocale` di `svelte-intlayer` e naviga verso l'URL localizzato quando un utente seleziona una nuova lingua:
 
@@ -367,7 +412,9 @@ La funzionalità di cambio lingua è integrata direttamente all'interno della Sv
 > **Nota sulla persistenza:**
 > L'uso di `onLocaleChange` per reindirizzare tramite `window.location.href` assicura che il nuovo URL linguistico venga visitato, consentendo al middleware Intlayer di impostare il cookie della lingua e di ricordare la preferenza dell'utente nelle visite future.
 
-### Passaggio 8: Sitemap e Robots.txt
+</Step>
+
+<Step number={8} title="Sitemap e Robots.txt">
 
 Intlayer offre utilità per creare dinamicamente la tua sitemap localizzata e i file robots.txt.
 
@@ -475,7 +522,9 @@ Per maggiori informazioni sull'utilizzo dell'estensione, consulta la [documentaz
 
 ---
 
-### (Opzionale) Passaggio 15: Estrarre il contenuto dei tuoi componenti
+</Step>
+
+<Step number={15} title="Estrarre il contenuto dei tuoi componenti" isOptional={true}>
 
 Se hai una base di codice esistente, trasformare migliaia di file può richiedere molto tempo.
 
@@ -576,3 +625,7 @@ bun run build # Or bun run dev
 ### Approfondisci
 
 Se vuoi saperne di più, puoi anche implementare il [Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md) o utilizzare il [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md) per esternalizzare i tuoi contenuti.
+
+</Step>
+
+</Steps>

package/docs/it/intlayer_with_astro_vanilla.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-24
-updatedAt: 2026-05-06
-title: Astro + Vanilla JS i18n - Come tradurre un'applicazione Astro + Vanilla JS nel 2026
-description: Scopri come aggiungere l'internazionalizzazione (i18n) al tuo sito Astro + Vanilla JS con Intlayer. Segui questa guida per rendere il tuo sito multilingue.
+updatedAt: 2026-05-31
+title: Astro + Vanilla JS i18n - Guida completa per tradurre Astro + Vanilla JS
+description: La migliore soluzione per dimensione del bundle, SEO, prestazioni & manutenibilità. Rendi il tuo Astro and Vanilla JS sito web multilingue nel 2026, traduzione LLM, Agent Skills & MCP.
 keywords:
   - internazionalizzazione
   - documentazione
@@ -58,16 +58,47 @@ history:
 
 <TOC/>
 
-## Cos'è Intlayer?
+## Perché Intlayer rispetto alle alternative?
 
-**Intlayer** è una libreria di internazionalizzazione (i18n) innovativa e open-source progettata per semplificare il supporto multilingue nelle moderne applicazioni web.
+Rispetto alle soluzioni principali come `astro-i18n` o `i18next`, Intlayer è una soluzione dotata di ottimizzazioni integrate come:
 
-Con Intlayer puoi:
+<AccordionGroup>
+<Accordion header="Copertura Astro completa">
 
-- **Gestire le traduzioni facilmente**: Utilizzando dizionari dichiarativi a livello di componente.
-- **Localizzare metadati, percorsi e contenuti dinamicamente**.
-- **Garantire il supporto TypeScript**: Con tipi autogenerati per migliorare l'autocompletamento e il rilevamento degli errori.
-- **Beneficiare di funzioni avanzate**: Come il rilevamento dinamico della lingua e il cambio di lingua.
+Intlayer è ottimizzato per funzionare perfettamente con Astro offrendo **routing multilingue**, **mappa del sito** e tutte le funzionalità necessarie per scalare l'internazionalizzazione (i18n).
+
+</Accordion>
+<Accordion header="Dimensione del bundle">
+
+Invece di caricare enormi file JSON nelle tue pagine, carica solo il contenuto necessario. Intlayer aiuta a **ridurre le dimensioni del bundle e della pagina fino al 50%**.
+
+</Accordion>
+<Accordion header="Manutenibilità">
+
+L'ambito del contenuto dell'applicazione **facilita la manutenzione** per applicazioni su larga scala. Puoi duplicare o eliminare una singola cartella di funzionalità senza l'onere mentale di rivedere l'intera codebase dei contenuti. Inoltre, Intlayer è **completamente tipizzato (fully typed)** per garantire l'accuratezza dei tuoi contenuti.
+
+</Accordion>
+<Accordion header="Agente IA">
+
+La co-localizzazione dei contenuti **riduce il contesto necessario** dai Large Language Models (LLM). Intlayer viene fornito anche con una suite di strumenti, come una **CLI** per verificare le traduzioni mancanti,**[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)** e **[capacità dell'agente](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**, per rendere l'esperienza dello sviluppatore (DX) ancora più fluida per gli agenti IA.
+
+</Accordion>
+<Accordion header="Automazione">
+
+Utilizza l'automazione per tradurre nella tua pipeline CI/CD utilizzando il LLM di tua scelta al costo del tuo provider di intelligenza artificiale. Intlayer offre anche un **compilatore** per automatizzare l'estrazione dei contenuti, nonché una [piattaforma web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md) per aiutare a **tradurre in background**.
+
+</Accordion>
+<Accordion header="Prestazione">
+
+La connessione di enormi file JSON ai componenti può portare a problemi di prestazioni e reattività. Intlayer ottimizza il caricamento dei contenuti in fase di compilazione.
+
+</Accordion>
+<Accordion header="Scalabilità con nessuno sviluppatore">
+
+Più di una semplice soluzione i18n, Intlayer fornisce un **[editor visivo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** self-hosted e un **[CMS completo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)** per aiutarti gestisci i tuoi contenuti multilingue in **tempo reale**, semplificando la collaborazione con traduttori, copywriter e altri membri del team. I contenuti possono essere archiviati localmente e/o in remoto.
+
+</Accordion>
+</AccordionGroup>
 
 ---
 
@@ -75,7 +106,9 @@ Con Intlayer puoi:
 
 Controlla il [template dell'applicazione](https://github.com/aymericzip/intlayer-astro-template) su GitHub.
 
-### Passaggio 1: Installare le dipendenze
+<Steps>
+
+<Step number={1} title="Installare le dipendenze">
 
 Installa i pacchetti necessari utilizzando il tuo gestore di pacchetti preferito:
 
@@ -112,7 +145,9 @@ bun x intlayer init
 - **vanilla-intlayer**
   Un pacchetto per integrare Intlayer in applicazioni Vanilla JavaScript / TypeScript. Fornisce un singleton Pub/Sub (`IntlayerClient`) e helper basati su chiamate (`useIntlayer`, `useLocale`, ecc.), consentendo a qualsiasi parte dei tuoi tag `<script>` Astro di rispondere ai cambi di lingua senza la necessità di un framework UI.
 
-### Passaggio 2: Configura il tuo progetto
+</Step>
+
+<Step number={2} title="Configura il tuo progetto">
 
 Crea un file di configurazione per definire le lingue della tua applicazione:
 
@@ -137,7 +172,9 @@ export default config;
 
 > Attraverso questo file di configurazione, puoi configurare URL localizzati, reindirizzamenti del middleware, nomi dei cookie, posizione ed estensioni delle dichiarazioni di contenuto, disabilitare i log di Intlayer nella console e altro ancora. Per un elenco completo dei parametri disponibili, consulta la [documentazione di configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md).
 
-### Passaggio 3: Integra Intlayer nella tua configurazione Astro
+</Step>
+
+<Step number={3} title="Integra Intlayer nella tua configurazione Astro">
 
 Aggiungi il plugin `intlayer` alla tua configurazione Astro. Per Vanilla JS, non è richiesta alcuna integrazione aggiuntiva del framework UI.
 
@@ -155,7 +192,9 @@ export default defineConfig({
 
 > Il plugin di integrazione `intlayer()` viene utilizzato per integrare Intlayer con Astro. Garantisce la generazione dei file di dichiarazione del contenuto e li monitora in modalità sviluppo. Definisce le variabili d'ambiente di Intlayer all'interno dell'applicazione Astro e fornisce alias per ottimizzare le prestazioni.
 
-### Passaggio 4: Dichiara i tuoi contenuti
+</Step>
+
+<Step number={4} title="Dichiara i tuoi contenuti">
 
 Crea e gestisci le tue dichiarazioni di contenuto per memorizzare le traduzioni:
 
@@ -193,7 +232,9 @@ export default appContent;
 
 > Per ulteriori informazioni, consulta la [documentazione sulla dichiarazione del contenuto](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/content_file.md).
 
-### Passaggio 5: Utilizzare il contenuto in Astro
+</Step>
+
+<Step number={5} title="Utilizzare il contenuto in Astro">
 
 Con Vanilla JS, tutto il rendering lato server avviene direttamente nei file `.astro` utilizzando `getIntlayer`. Successivamente, un blocco `<script>` inizializza `vanilla-intlayer` sul client per abilitare il cambio di lingua.
 
@@ -302,7 +343,9 @@ const { greeting, description, switchLocale } = getIntlayer("app", locale);
 > - **`prefix-all`:** tutti gli URL hanno il prefisso della lingua. Puoi usare lo standard `[locale]` se non hai bisogno di gestire la radice separatamente.
 > - **`search-param` o `no-prefix`:** non sono necessarie directory per la lingua. La lingua viene gestita tramite parametri di query o cookie.
 
-### Passaggio 6: Aggiungere il selettore di lingua
+</Step>
+
+<Step number={6} title="Aggiungere il selettore di lingua">
 
 In Astro con Vanilla JS, il selettore di lingua viene renderizzato sul server come normali collegamenti e idratato sul client tramite un blocco `<script>`. Quando un utente clicca su un link della lingua, `vanilla-intlayer` imposta il cookie della lingua tramite `setLocale` prima di navigare verso l'URL localizzato.
 
@@ -343,7 +386,9 @@ In Astro con Vanilla JS, il selettore di lingua viene renderizzato sul server co
 > **Nota sul miglioramento progressivo (Progressive Enhancement):**
 > I link nel selettore di lingua funzioneranno come tag `<a>` standard anche senza JavaScript. Quando JavaScript è disponibile, le chiamate a `setLocale` aggiorneranno il cookie prima della navigazione, assicurando che il middleware esegua il reindirizzamento corretto.
 
-### Passaggio 7: Sitemap e Robots.txt
+</Step>
+
+<Step number={7} title="Sitemap e Robots.txt">
 
 Intlayer offre utilità per creare dinamicamente la tua sitemap localizzata e i file robots.txt.
 
@@ -451,7 +496,9 @@ Per maggiori informazioni sull'utilizzo dell'estensione, consulta la [documentaz
 
 ---
 
-### (Opzionale) Passaggio 15: Estrarre il contenuto dei tuoi componenti
+</Step>
+
+<Step number={15} title="Estrarre il contenuto dei tuoi componenti" isOptional={true}>
 
 Se hai una base di codice esistente, trasformare migliaia di file può richiedere molto tempo.
 
@@ -552,3 +599,7 @@ bun run build # Or bun run dev
 ### Approfondisci
 
 Se vuoi saperne di più, puoi anche implementare il [Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md) o utilizzare il [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md) per esternalizzare i tuoi contenuti.
+
+</Step>
+
+</Steps>

package/docs/it/intlayer_with_astro_vue.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-24
-updatedAt: 2026-05-06
-title: Astro + Vue i18n - Come tradurre un'applicazione Astro + Vue nel 2026
-description: Scopri come aggiungere l'internazionalizzazione (i18n) al tuo sito Astro + Vue con Intlayer. Segui questa guida per rendere il tuo sito multilingue.
+updatedAt: 2026-05-31
+title: Astro + Vue i18n - Guida completa per tradurre Astro + Vue
+description: La migliore soluzione per dimensione del bundle, SEO, prestazioni & manutenibilità. Rendi il tuo Astro and Vue sito web multilingue nel 2026, traduzione LLM, Agent Skills & MCP.
 keywords:
   - internazionalizzazione
   - documentazione
@@ -58,16 +58,47 @@ history:
 
 <TOC/>
 
-## Cos'è Intlayer?
+## Perché Intlayer rispetto alle alternative?
 
-**Intlayer** è una libreria di internazionalizzazione (i18n) innovativa e open-source progettata per semplificare il supporto multilingue nelle moderne applicazioni web.
+Rispetto alle soluzioni principali come `astro-i18n` o `i18next`, Intlayer è una soluzione dotata di ottimizzazioni integrate come:
 
-Con Intlayer puoi:
+<AccordionGroup>
+<Accordion header="Copertura Astro completa">
 
-- **Gestire le traduzioni facilmente**: Utilizzando dizionari dichiarativi a livello di componente.
-- **Localizzare metadati, percorsi e contenuti dinamicamente**.
-- **Garantire il supporto TypeScript**: Con tipi autogenerati per migliorare l'autocompletamento e il rilevamento degli errori.
-- **Beneficiare di funzioni avanzate**: Come il rilevamento dinamico della lingua e il cambio di lingua.
+Intlayer è ottimizzato per funzionare perfettamente con Astro offrendo **routing multilingue**, **mappa del sito** e tutte le funzionalità necessarie per scalare l'internazionalizzazione (i18n).
+
+</Accordion>
+<Accordion header="Dimensione del bundle">
+
+Invece di caricare enormi file JSON nelle tue pagine, carica solo il contenuto necessario. Intlayer aiuta a **ridurre le dimensioni del bundle e della pagina fino al 50%**.
+
+</Accordion>
+<Accordion header="Manutenibilità">
+
+L'ambito del contenuto dell'applicazione **facilita la manutenzione** per applicazioni su larga scala. Puoi duplicare o eliminare una singola cartella di funzionalità senza l'onere mentale di rivedere l'intera codebase dei contenuti. Inoltre, Intlayer è **completamente tipizzato (fully typed)** per garantire l'accuratezza dei tuoi contenuti.
+
+</Accordion>
+<Accordion header="Agente IA">
+
+La co-localizzazione dei contenuti **riduce il contesto necessario** dai Large Language Models (LLM). Intlayer viene fornito anche con una suite di strumenti, come una **CLI** per verificare le traduzioni mancanti,**[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)** e **[capacità dell'agente](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**, per rendere l'esperienza dello sviluppatore (DX) ancora più fluida per gli agenti IA.
+
+</Accordion>
+<Accordion header="Automazione">
+
+Utilizza l'automazione per tradurre nella tua pipeline CI/CD utilizzando il LLM di tua scelta al costo del tuo provider di intelligenza artificiale. Intlayer offre anche un **compilatore** per automatizzare l'estrazione dei contenuti, nonché una [piattaforma web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md) per aiutare a **tradurre in background**.
+
+</Accordion>
+<Accordion header="Prestazione">
+
+La connessione di enormi file JSON ai componenti può portare a problemi di prestazioni e reattività. Intlayer ottimizza il caricamento dei contenuti in fase di compilazione.
+
+</Accordion>
+<Accordion header="Scalabilità con nessuno sviluppatore">
+
+Più di una semplice soluzione i18n, Intlayer fornisce un **[editor visivo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** self-hosted e un **[CMS completo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)** per aiutarti gestisci i tuoi contenuti multilingue in **tempo reale**, semplificando la collaborazione con traduttori, copywriter e altri membri del team. I contenuti possono essere archiviati localmente e/o in remoto.
+
+</Accordion>
+</AccordionGroup>
 
 ---
 
@@ -75,7 +106,9 @@ Con Intlayer puoi:
 
 Controlla il [template dell'applicazione](https://github.com/aymericzip/intlayer-astro-template) su GitHub.
 
-### Passaggio 1: Installare le dipendenze
+<Steps>
+
+<Step number={1} title="Installare le dipendenze">
 
 Installa i pacchetti necessari utilizzando il tuo gestore di pacchetti preferito:
 
@@ -118,7 +151,9 @@ bun x intlayer init
 - **@astrojs/vue**
   Integrazione ufficiale di Astro che consente l'uso di islands di componenti Vue.
 
-### Passaggio 2: Configura il tuo progetto
+</Step>
+
+<Step number={2} title="Configura il tuo progetto">
 
 Crea un file di configurazione per definire le lingue della tua applicazione:
 
@@ -143,7 +178,9 @@ export default config;
 
 > Attraverso questo file di configurazione, puoi configurare URL localizzati, reindirizzamenti del middleware, nomi dei cookie, posizione ed estensioni delle dichiarazioni di contenuto, disabilitare i log di Intlayer nella console e altro ancora. Per un elenco completo dei parametri disponibili, consulta la [documentazione di configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md).
 
-### Passaggio 3: Integra Intlayer nella tua configurazione Astro
+</Step>
+
+<Step number={3} title="Integra Intlayer nella tua configurazione Astro">
 
 Aggiungi il plugin `intlayer` e l'integrazione Vue alla tua configurazione Astro.
 
@@ -164,7 +201,9 @@ export default defineConfig({
 
 > L'integrazione `vue()` consente di utilizzare islands di componenti Vue tramite `client:only="vue"`.
 
-### Passaggio 4: Dichiara i tuoi contenuti
+</Step>
+
+<Step number={4} title="Dichiara i tuoi contenuti">
 
 Crea e gestisci le tue dichiarazioni di contenuto per memorizzare le traduzioni:
 
@@ -190,7 +229,9 @@ export default appContent;
 
 > Per ulteriori informazioni, consulta la [documentazione sulla dichiarazione del contenuto](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/content_file.md).
 
-### Passaggio 5: Utilizzare il contenuto in Astro
+</Step>
+
+<Step number={5} title="Utilizzare il contenuto in Astro">
 
 Puoi consumare i dizionari direttamente nei tuoi file `.astro` utilizzando gli helper core esportati da `intlayer`. Dovresti anche aggiungere metadati SEO (come hreflang e link canonici) a ogni pagina e introdurre una Vue island per i contenuti interattivi lato client.
 
@@ -270,7 +311,9 @@ const { title } = getIntlayer("app", locale);
 > - **`prefix-all`:** tutti gli URL hanno il prefisso della lingua. Puoi usare lo standard `[locale]` se non hai bisogno di gestire la radice separatamente.
 > - **`search-param` o `no-prefix`:** non sono necessarie directory per la lingua. La lingua viene gestita tramite parametri di query o cookie.
 
-### Passaggio 6: Crea un componente Vue Island
+</Step>
+
+<Step number={6} title="Crea un componente Vue Island">
 
 Crea un componente island che racchiuda la tua applicazione Vue e riceva la lingua rilevata dal server. Devi registrare il plugin Intlayer nella tua istanza Vue chiamando `installIntlayer` prima di utilizzare qualsiasi composable.
 
@@ -329,7 +372,9 @@ const { title } = useIntlayer("app");
 
 > La prop `locale` viene passata dalla pagina Astro (rilevamento lato server) e utilizzata per inizializzare `installIntlayer`, impostando la lingua iniziale per tutti i composable all'interno dell'albero.
 
-### Passaggio 7: Aggiungi un selettore di lingua
+</Step>
+
+<Step number={7} title="Aggiungi un selettore di lingua">
 
 La funzionalità di cambio lingua è integrata direttamente nel template della Vue island (vedi passaggio 6 sopra). Utilizza il composable `useLocale` di `vue-intlayer` e naviga verso l'URL localizzato quando un utente seleziona una nuova lingua:
 
@@ -377,7 +422,9 @@ const {
 > **Nota sulla persistenza:**
 > L'uso di `onLocaleChange` per reindirizzare tramite `window.location.href` assicura che il nuovo URL linguistico venga visitato, consentendo al middleware Intlayer di impostare il cookie della lingua e di ricordare la preferenza dell'utente nelle visite future.
 
-### Passaggio 8: Sitemap e Robots.txt
+</Step>
+
+<Step number={8} title="Sitemap e Robots.txt">
 
 Intlayer offre utilità per creare dinamicamente la tua sitemap localizzata e i file robots.txt.
 
@@ -485,7 +532,9 @@ Per maggiori informazioni sull'utilizzo dell'estensione, consulta la [documentaz
 
 ---
 
-### (Opzionale) Passaggio 15: Estrarre il contenuto dei tuoi componenti
+</Step>
+
+<Step number={15} title="Estrarre il contenuto dei tuoi componenti" isOptional={true}>
 
 Se hai una base di codice esistente, trasformare migliaia di file può richiedere molto tempo.
 
@@ -586,3 +635,7 @@ bun run build # Or bun run dev
 ### Approfondisci
 
 Se vuoi saperne di più, puoi anche implementare il [Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md) o utilizzare il [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md) per esternalizzare i tuoi contenuti.
+
+</Step>
+
+</Steps>

package/docs/it/intlayer_with_create_react_app.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2026-05-06
-title: Create React App i18n - Come tradurre un'app React nel 2026
-description: Scopri come rendere il tuo sito Create React App (CRA) multilingue. Segui la documentazione per internazionalizzare (i18n) e tradurlo.
+updatedAt: 2026-05-31
+title: Create React App i18n - Guida completa per tradurre React
+description: La migliore soluzione per dimensione del bundle, SEO, prestazioni & manutenibilità. Rendi il tuo Create React App sito web multilingue nel 2026, traduzione LLM, Agent Skills & MCP.
 keywords:
   - Internazionalizzazione
   - Documentazione
@@ -45,7 +45,9 @@ Con Intlayer, puoi:
 
 ## Guida passo-passo per configurare Intlayer in un'applicazione React
 
-### Passo 1: Installa le dipendenze
+<Steps>
+
+<Step number={1} title="Installa le dipendenze">
 
 Installa i pacchetti necessari utilizzando npm:
 
@@ -80,7 +82,9 @@ bun x intlayer init
 - **react-scripts-intlayer**
   Include i comandi e i plugin `react-scripts-intlayer` per integrare Intlayer con l'applicazione basata su Create React App. Questi plugin sono basati su [craco](https://craco.js.org/) e includono configurazioni aggiuntive per il bundler [Webpack](https://webpack.js.org/).
 
-### Passo 2: Configurazione del progetto
+</Step>
+
+<Step number={2} title="Configurazione del progetto">
 
 Crea un file di configurazione per configurare le lingue della tua applicazione:
 
@@ -104,7 +108,9 @@ export default config;
 
 > Tramite questo file di configurazione, puoi configurare URL localizzati, reindirizzamenti middleware, nomi dei cookie, la posizione e l'estensione delle dichiarazioni dei contenuti, disabilitare i log di Intlayer nella console e altro. Per un elenco completo dei parametri disponibili, consulta la [documentazione di configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md).
 
-### Passo 3: Integra Intlayer nella configurazione CRA
+</Step>
+
+<Step number={3} title="Integra Intlayer nella configurazione CRA">
 
 Modifica i tuoi script per utilizzare react-intlayer
 
@@ -118,13 +124,17 @@ Modifica i tuoi script per utilizzare react-intlayer
 
 > Gli script `react-scripts-intlayer` sono basati su [CRACO](https://craco.js.org/). Puoi anche implementare la tua configurazione basata sul plugin craco di Intlayer. [Vedi esempio qui](https://github.com/aymericzip/intlayer/blob/main/examples/react-app/craco.config.js).
 
-### Passo 4: Dichiarare i tuoi contenuti
+</Step>
+
+<Step number={4} title="Dichiarare i tuoi contenuti">
 
 Crea e gestisci le dichiarazioni dei tuoi contenuti per memorizzare le traduzioni:
 
 > Gli script `react-scripts-intlayer` sono basati su [CRACO](https://craco.js.org/). Puoi anche implementare la tua configurazione basata sul plugin craco di Intlayer. [Vedi esempio qui](https://github.com/aymericzip/intlayer/blob/main/examples/react-app/craco.config.js).
 
-### Passo 4: Dichiarare i tuoi contenuti
+</Step>
+
+<Step number={4} title="Dichiarare i tuoi contenuti">
 
 Crea e gestisci le dichiarazioni dei tuoi contenuti per memorizzare le traduzioni:
 
@@ -200,7 +210,9 @@ module.exports = appContent;
 
 > Se il tuo file di contenuti include codice TSX, considera di importare `import React from "react";` nel tuo file di contenuti.
 
-### Passo 5: Utilizza Intlayer nel tuo codice
+</Step>
+
+<Step number={5} title="Utilizza Intlayer nel tuo codice">
 
 Accedi ai tuoi dizionari di contenuti in tutta l'applicazione:
 
@@ -249,7 +261,9 @@ export default App;
 >
 > Per saperne di più sull'hook `useIntlayer`, consulta la [documentazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/useIntlayer.md).
 
-### (Opzionale) Passo 6: Cambia la lingua dei tuoi contenuti
+</Step>
+
+<Step number={6} title="Cambia la lingua dei tuoi contenuti" isOptional={true}>
 
 Per cambiare la lingua dei tuoi contenuti, puoi utilizzare la funzione `setLocale` fornita dall'hook `useLocale`. Questa funzione ti consente di impostare la lingua dell'applicazione e aggiornare i contenuti di conseguenza.
 
@@ -270,7 +284,9 @@ const LocaleSwitcher = () => {
 
 > Per saperne di più sull'hook `useLocale`, consulta la [documentazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/useLocale.md).
 
-### (Opzionale) Passo 7: Aggiungi routing localizzato alla tua applicazione
+</Step>
+
+<Step number={7} title="Aggiungi routing localizzato alla tua applicazione" isOptional={true}>
 
 Lo scopo di questo passaggio è creare percorsi univoci per ogni lingua. Questo è utile per la SEO e per URL SEO-friendly.
 Esempio:
@@ -415,7 +431,9 @@ const App: FC = () => (
 );
 ```
 
-### (Opzionale) Passo 8: Cambiare l'URL quando la lingua cambia
+</Step>
+
+<Step number={8} title="Cambiare l'URL quando la lingua cambia" isOptional={true}>
 
 Per cambiare l'URL quando la lingua cambia, puoi usare la proprietà `onLocaleChange` fornita dall'hook `useLocale`. Parallelamente, puoi usare gli hook `useLocation` e `useNavigate` di `react-router-dom` per aggiornare il percorso URL.
 
@@ -497,7 +515,9 @@ const LocaleSwitcher: FC = () => {
 > - [`dir` attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/dir)
 > - [`aria-current` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-current)
 
-### (Opzionale) Passo 9: Modificare gli attributi di lingua e direzione dell’HTML
+</Step>
+
+<Step number={9} title="Modificare gli attributi di lingua e direzione dell’HTML" isOptional={true}>
 
 Quando la tua applicazione supporta più lingue, è fondamentale aggiornare gli attributi `lang` e `dir` del tag `<html>` per farli corrispondere alla locale corrente. Questo garantisce:
 
@@ -630,3 +650,7 @@ Per maggiori dettagli su come utilizzare l'estensione, consulta la [documentazio
 ### Approfondimenti
 
 Per approfondire, puoi implementare l’[editor visuale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md) o esternalizzare i tuoi contenuti usando il [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md).
+
+</Step>
+
+</Steps>

package/docs/it/intlayer_with_express.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2026-05-06
-title: Express i18n - Come tradurre un'app Express nel 2026
-description: Scopri come rendere il tuo backend Express multilingue. Segui la documentazione per internazionalizzare (i18n) e tradurlo.
+updatedAt: 2026-05-31
+title: Express i18n - Guida completa per tradurre Express
+description: La migliore soluzione per dimensione del bundle, SEO, prestazioni & manutenibilità. Rendi il tuo Express backend multilingue nel 2026, traduzione LLM, Agent Skills & MCP.
 keywords:
   - Internazionalizzazione
   - Documentazione