@intlayer/docs 9.0.0-canary.9 → 9.0.1

package/docs/it/intlayer_with_vite+vanilla.md

@@ -119,19 +119,19 @@ Più di una semplice soluzione i18n, Intlayer fornisce un **[editor visivo](http
 Installa i pacchetti necessari utilizzando npm:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.

package/docs/it/intlayer_with_vite+vue.md

@@ -90,7 +90,7 @@ Più di una semplice soluzione i18n, Intlayer fornisce un **[editor visivo](http
 
 <Tabs defaultTab="video">
   <Tab label="Video" value="video">
-  
+
 <iframe title="The best i18n solution for Vite and Vue? Discover Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/IE3XWkZ6a5U?autoplay=0&amp;origin=https://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </Tab>
@@ -116,19 +116,19 @@ Vedi il [Modello di Applicazione](https://github.com/aymericzip/intlayer-vite-vu
 Installa i pacchetti necessari usando npm:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.

package/docs/it/live-sync.md

@@ -0,0 +1,174 @@
+---
+createdAt: 2026-07-08
+updatedAt: 2026-07-08
+title: Sincronizzazione live | Rifletti le modifiche dei contenuti del CMS in tempo reale
+description: Consenti alla tua applicazione di riflettere le modifiche dei contenuti del CMS Intlayer in tempo reale, senza ricompilazione né nuova distribuzione.
+keywords:
+  - Sincronizzazione live
+  - Live Sync
+  - CMS
+  - Editor Visivo
+  - Internazionalizzazione
+  - Documentazione
+  - Intlayer
+  - Next.js
+  - Vite
+history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "Spostato dalla documentazione del CMS Intlayer in una pagina dedicata"
+  - version: 6.0.1
+    date: 2025-09-22
+    changes: "Aggiunta documentazione sulla sincronizzazione live"
+  - version: 6.0.0
+    date: 2025-09-04
+    changes: "Sostituito il campo `hotReload` con `liveSync`"
+author: aymericzip
+---
+
+# Sincronizzazione live
+
+La Sincronizzazione Live consente alla tua app di riflettere le modifiche ai contenuti del CMS in tempo reale. Non è necessario ricostruire o ridistribuire. Quando abilitata, gli aggiornamenti vengono trasmessi a un server di Sincronizzazione Live che aggiorna i dizionari letti dalla tua applicazione.
+
+## Indice
+
+<TOC/>
+
+---
+
+## Attivare la sincronizzazione live
+
+> Live Sync richiede una connessione continua al server ed è disponibile nel piano enterprise.
+
+Abilita Live Sync aggiornando la configurazione di Intlayer:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... altre impostazioni di configurazione
+  editor: {
+    /**
+     * Abilita il caricamento a caldo delle configurazioni locali quando vengono rilevate modifiche.
+     * Ad esempio, quando un dizionario viene aggiunto o aggiornato, l'applicazione aggiorna
+     * il contenuto visualizzato nella pagina.
+     *
+     * Poiché il caricamento a caldo richiede una connessione continua al server, è
+     * disponibile solo per i clienti del piano `enterprise`.
+     *
+     * Predefinito: false
+     */
+    liveSync: true,
+  },
+  dictionary: {
+    /**
+     * Controlla come vengono importati i dizionari:
+     *
+     * - "live": I dizionari vengono recuperati dinamicamente utilizzando l'API Live Sync.
+     *   Sostituisce useIntlayer con useDictionaryDynamic.
+     *
+     * Nota: La modalità live utilizza l'API Live Sync per recuperare i dizionari. Se la chiamata API
+     * fallisce, i dizionari vengono importati dinamicamente.
+     * Nota: Solo i dizionari con contenuto remoto e flag "live" utilizzano la modalità live.
+     * Gli altri usano la modalità dinamica per le prestazioni.
+     */
+    importMode: "fetch",
+  },
+};
+
+export default config;
+```
+
+Avvia il server Live Sync per avvolgere la tua applicazione:
+
+Esempio con Next.js:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... altri script
+    "build": "next build",
+    "dev": "next dev",
+    "start": "npx intlayer live --with 'next start'",
+  },
+}
+```
+
+Esempio con Vite:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... altri script
+    "build": "vite build",
+    "dev": "vite dev",
+    "start": "npx intlayer live --with 'vite start'",
+  },
+}
+```
+
+Il server Live Sync avvolge la tua applicazione e applica automaticamente i contenuti aggiornati non appena arrivano.
+
+Per ricevere notifiche di modifica dal CMS, il server Live Sync mantiene una connessione SSE con il backend. Quando il contenuto cambia nel CMS, il backend inoltra l'aggiornamento al server Live Sync, che scrive i nuovi dizionari. La tua applicazione rifletterà l'aggiornamento alla successiva navigazione o al reload del browser, non è necessario ricostruire.
+
+Diagramma di flusso (CMS/Backend -> Server Live Sync -> Server Applicazione -> Frontend):
+
+![Schema Logica Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
+
+Come funziona:
+
+![Schema Flusso Live Sync CMS/Backend/Server Live Sync/Server Applicazione/Frontend](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
+
+## Flusso di lavoro di sviluppo (locale)
+
+- In fase di sviluppo, tutti i dizionari remoti vengono recuperati all'avvio dell'applicazione, così puoi testare rapidamente gli aggiornamenti.
+- Per testare Live Sync localmente con Next.js, avvolgi il tuo server di sviluppo:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... altri script
+    "dev": "npx intlayer live --with 'next dev'",
+    // "dev": "npx intlayer live --with 'vite dev'", // Per Vite
+  },
+}
+```
+
+Abilita l'ottimizzazione affinché Intlayer applichi le trasformazioni di importazione Live durante lo sviluppo:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    applicationURL: "http://localhost:5173",
+    liveSyncURL: "http://localhost:4000",
+    liveSync: true,
+  },
+  dictionary: {
+    importMode: "fetch",
+  },
+  build: {
+    optimize: true,
+  },
+};
+
+export default config;
+```
+
+Questa configurazione avvolge il tuo server di sviluppo con il server Live Sync, recupera i dizionari remoti all'avvio e trasmette aggiornamenti dal CMS tramite SSE. Aggiorna la pagina per vedere le modifiche.
+
+## Note e vincoli
+
+- Aggiungi l'origine del live sync alla tua politica di sicurezza del sito (CSP). Assicurati che l'URL del live sync sia consentito in `connect-src` (e in `frame-ancestors` se pertinente).
+- Live Sync non funziona con output statico. Per Next.js, la pagina deve essere dinamica per ricevere aggiornamenti in fase di esecuzione (ad esempio, usa `generateStaticParams`, `generateMetadata`, `getServerSideProps` o `getStaticProps` in modo appropriato per evitare vincoli di solo statico completo).
+- Nel CMS, ogni dizionario ha un flag `live`. Solo i dizionari con `live=true` vengono recuperati tramite l'API di live sync; gli altri vengono importati dinamicamente e rimangono invariati a runtime.
+- Il flag `live` viene valutato per ogni dizionario al momento della build. Se il contenuto remoto non era contrassegnato come `live=true` durante la build, è necessario ricostruire per abilitare Live Sync per quel dizionario.
+- Il server di live sync deve poter scrivere nella cartella `.intlayer`. Nei container, assicurarsi che sia garantito l'accesso in scrittura a `/.intlayer`.
+
+## Link utili
+
+- [CMS Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md)
+- [Editor Visivo di Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md)
+- [Riferimento di configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md)
+- [Guida al Self-Hosting](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/self_hosting.md)

package/docs/it/migration_from_i18next_to_intlayer.md

@@ -99,19 +99,19 @@ I seguenti passaggi rappresentano il minimo indispensabile per far funzionare la
 Installa i pacchetti principali di Intlayer e l'adattatore di compatibilità:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.

package/docs/it/migration_from_next-i18next_to_intlayer.md

@@ -102,19 +102,19 @@ I seguenti passaggi rappresentano il minimo indispensabile per far funzionare la
 Installa i pacchetti principali di Intlayer e gli adattatori di compatibilità:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.

package/docs/it/migration_from_next-intl_to_intlayer.md

@@ -98,19 +98,19 @@ I seguenti passaggi rappresentano il minimo indispensabile per far funzionare la
 Installa i pacchetti principali di Intlayer e l'adattatore di compatibilità `@intlayer/next-intl`:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.

package/docs/it/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -101,19 +101,19 @@ I seguenti passaggi rappresentano il minimo indispensabile per far funzionare la
 Installa i pacchetti principali di Intlayer e l'adattatore di compatibilità:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.

package/docs/it/migration_from_react-i18next_to_intlayer.md

@@ -101,19 +101,19 @@ I seguenti passaggi rappresentano il minimo indispensabile per far funzionare la
 Installa i pacchetti principali di Intlayer e l'adattatore di compatibilità:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.
@@ -209,9 +209,7 @@ import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
 
 const withIntlayer = createNextI18nPlugin();
 
-const nextConfig: NextConfig = {
-  /* le tue opzioni di configurazione */
-};
+const nextConfig: NextConfig = {/* le tue opzioni di configurazione */};
 
 export default withIntlayer(nextConfig);
 ```

package/docs/it/migration_from_vue-i18n_to_intlayer.md

@@ -100,19 +100,19 @@ I seguenti passaggi rappresentano il minimo indispensabile per far funzionare la
 Installa i pacchetti principali di Intlayer e l'adattatore di compatibilità:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > il flag `--interactive` è opzionale. Usa `intlayer-cli init` se sei un agente IA.

package/docs/it/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-07-08
 title: Nuovo Intlayer v9 - Cosa c'è di nuovo?
 description: Scopri le novità di Intlayer v9. Introduzione di package di compatibilità drop-in per le più diffuse librerie i18n e supporto per Collections e Variants.
 keywords:
@@ -9,9 +9,13 @@ keywords:
   - Migrazione
   - Collections
   - Variants
+  - CMS SDK
+  - Self-Hosting
+  - Docker
   - i18next
   - next-intl
   - vue-i18n
+youtubeVideo: https://www.youtube.com/watch?v=zmCN4z_B4jk
 slugs:
   - doc
   - releases
@@ -23,6 +27,14 @@ author: aymericzip
 
 Benvenuti a Intlayer v9! Questa major release segna un'enorme pietra miliare nella semplificazione del percorso di migrazione a Intlayer con i **Compat Adapter Packages** per le principali librerie i18n (`react-i18next`, `next-intl`, `vue-i18n`, ecc.) e aggiunge il supporto per strutture di contenuto ricche: **Collections** e **Variants**.
 
+<iframe
+  src="https://www.youtube.com/embed/zmCN4z_B4jk"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo Video - New Intlayer v9 - What's new?"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
 ## Indice
 
 <TOC levels={[2]} maxDepth={1} />
@@ -109,36 +121,40 @@ Intlayer v9 si espande oltre gli oggetti chiave-valore statici, consentendo ai d
 
 Definisci un elenco di elementi ordinati gestito da CMS (ad esempio FAQ, prodotti o elenchi di blog):
 
-```ts fileName="faq.content.ts"
+```ts fileName="faq.1.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "faq",
-  content: [
-    {
-      question: t({
-        it: "Cos'è Intlayer?",
-        en: "What is Intlayer?",
-        fr: "Qu'est-ce qu'Intlayer ?",
-      }),
-      answer: t({
-        it: "Un toolkit i18n.",
-        en: "An i18n toolkit.",
-        fr: "Une boîte à outils i18n.",
-      }),
-    },
-  ],
+  item: 1,
+  content: {
+    question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
+    answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
+  },
+} satisfies Dictionary;
+```
+
+```ts fileName="faq.2.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 2,
+  content: {
+    question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
+    answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
+  },
 } satisfies Dictionary;
 ```
 
 #### Utilizzo:
 
 ```ts
-// Recupera tutti gli elementi
+// Fetch all items as an array
 const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
 
-// Recupera un singolo elemento per indice
-const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+// Fetch a single item by index
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
 ```
 
 ### 2. Variants
@@ -192,28 +208,52 @@ export default {
 ```ts
 // Recupera solo l'elemento richiesto dinamicamente (richiede Suspense)
 const product = useIntlayer("product-copy", {
-  id: "prod_123",
-  category: "books",
+  variant: { id: "prod_123", category: "books" },
 });
 ```
 
 ---
 
-## Caricamento Dinamico e Ottimizzazioni delle Dimensioni del Bundle
-
-Per mantenere i bundle estremamente piccoli, Intlayer v9 supporta il caricamento dinamico lazy loading.
-
-Nella tua configurazione, imposta `importMode` su `'dynamic'` o `'fetch'`:
-
-```ts fileName="intlayer.config.ts"
-export default {
-  dictionary: {
-    importMode: "dynamic", // "static" | "dynamic" | "fetch"
-  },
+## `@intlayer/analytics`: tracciamento dell'esposizione dei contenuti e test A/B
+
+Un nuovo pacchetto opzionale, [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md), ti mostra quali contenuti vengono effettivamente visualizzati dai tuoi visitatori — chiudendo il cerchio con **Collections & Variants** permettendoti di eseguire test A/B sui contenuti e misurare le conversioni per variante.
+
+- **Tracciamento a livello di provider**: `IntlayerProvider` (React / Next.js / React Native) registra automaticamente eventi `page_view` al caricamento, al cambio di rotta e al cambio di lingua.
+- **Tracciamento a livello di nodo**: ogni risoluzione di `useIntlayer` segnala un evento `content_exposure` — quale chiave del dizionario, percorso della chiave, lingua e, quando applicabile, quale **variante** A/B è stata mostrata. Le esposizioni ripetute dello stesso nodo all'interno di una finestra di invio vengono unite in un unico evento.
+- **Assegnazione A/B deterministica**: `getVariant(experimentKey, variants)` assegna una variante a ogni sessione **senza andata e ritorno al server**, quindi nessuno sfarfallio prima del primo rendering.
+- **`useConversion()`**: attribuisce un obiettivo (registrazione, clic, acquisto…) alla variante a cui la sessione è stata esposta.
+- **Costo zero se non installato**: stesso schema tree-shakeable di `@intlayer/editor` — `import()` dinamico avvolto in `try/catch`, più una variabile d'ambiente a tempo di compilazione (`INTLAYER_ANALYTICS_ENABLED`) che elimina completamente l'integrazione dal bundle per le app che non la attivano.
+- **Nessun nuovo schema di configurazione**: riutilizza `editor.backendURL` (endpoint di invio / self-hosting) ed `editor.clientId` (chiave del progetto, che funge anche da interruttore di attivazione).
+- **Rispettoso della privacy**: hashing anonimo della sessione (SHA-256, nessun id grezzo memorizzato), nessuna memorizzazione dell'IP, geolocalizzazione approssimativa limitata al paese, richieste inviate in batch circa ogni 20 secondi.
+- **Dashboard**: una nuova pagina **Analytics** (visibile nella barra laterale una volta selezionato un progetto) mostra utenti attivi, utenti di oggi, utenti degli ultimi 7/30/90 giorni, un grafico dell'evoluzione dei visitatori e la suddivisione per lingua e posizione.
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      Get started
+    </button>
+  );
 };
 ```
 
-In fase di build, `@intlayer/swc` e `@intlayer/babel` scansionano i tuoi file e sostituiscono le chiamate `useIntlayer` / `getIntlayer` con wrapper tree-shakeable (`useDictionary` / `useDictionaryDynamic`). Viene caricato solo il contenuto richiesto per l'elemento della collection, la variante o la locale selezionati, impedendo al tuo bundle di produzione di contenere traduzioni inutilizzate.
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+Disponibile già oggi per React, Next.js e React Native (tramite `react-intlayer`); altri binding per framework (Vue, Svelte, Angular, …) sono pianificati, seguendo lo stesso schema di rilascio di `@intlayer/editor`. Consulta la [documentazione di Analytics](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) per la guida completa.
 
 ---
 
@@ -296,13 +336,68 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## SDK CMS: usa Intlayer come database di contenuti headless
+
+Intlayer v9 include un SDK pulito e con autenticazione automatica in `@intlayer/api` per interagire con il CMS in modo programmatico — recuperare progetti, recuperare dizionari e inviarli o aggiornarli dal tuo server, script o CI. L'autenticazione (OAuth2 `client_credentials`) è gestita e rinnovata automaticamente.
+
+L'SDK è suddiviso in **due import separati**, così il tuo bundle include solo i domini che usi davvero:
+
+1. `createIntlayerCMS` — un **autenticatore** leggero che custodisce le credenziali e il token gestito (nessun client di dominio incluso).
+2. `dictionaryEndpoint`, `projectEndpoint`, … — **binder di endpoint** per dominio, ciascuno importato dal proprio sottopercorso.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// La configurazione è opzionale: le credenziali ricadono su INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET risolti da `@intlayer/config/built`.
+const cms = createIntlayerCMS();
+
+// Lettura
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// Scrittura — usa il CMS come un database
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> Sicurezza: le credenziali del CMS concedono l'accesso in scrittura ai tuoi contenuti. Crea l'autenticatore sempre **lato server** — non inviare mai `clientId` / `clientSecret` al browser.
+
+---
+
+## Self-Hosting
+
+Intlayer v9 offre supporto di prima classe per eseguire la propria istanza di Intlayer con un singolo comando — nessun account Intlayer Cloud richiesto.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Il programma di installazione scarica un `docker-compose.yml` e un `.env`, genera automaticamente i secret necessari ed esegue `docker compose up -d`. Tutto — il dashboard, l'API, il database, l'archiviazione di oggetti e le email transazionali — viene eseguito localmente nei container.
+
+### Servizi inclusi
+
+| Servizio                                | Scopo                                                                         |
+| --------------------------------------- | ----------------------------------------------------------------------------- |
+| **app** (TanStack Start)                | Interfaccia del dashboard sulla porta `3000`                                  |
+| **backend** (Fastify/Bun)               | API REST sulla porta `3100`                                                   |
+| **MongoDB 7** (single-node replica set) | Database principale                                                           |
+| **Redis 7**                             | Code di lavori e caching                                                      |
+| **MinIO**                               | Archiviazione di oggetti compatibile S3 (avatar, screenshot)                  |
+| **Mailpit**                             | Sink SMTP locale + interfaccia web per email transazionali sulla porta `8025` |
+
+Chromium (utilizzato per la generazione di screenshot con Puppeteer) è incluso nell'immagine del backend — nessun container aggiuntivo necessario.
+
+---
+
 ## Note di migrazione da v8
 
 Se stai eseguendo l'aggiornamento da v8, nota che la v9 non include breaking changes. Ma ecco le modifiche chiave:
 
 - **Compilatore disabilitato per impostazione predefinita**: `compiler.enabled` ora ha come valore predefinito `false`. Se dipendi dall'estrazione dei tuoi file `.content.ts` in fase di build, imposta `compiler.enabled: true` nel tuo `intlayer.config.ts`.
+- **Plugin Vite**: Il compilatore e il proxy di routing locale sono ora integrati in `intlayer()`. Se in precedenza hai registrato `intlayerCompiler()` o `intlayerProxy()` manualmente, puoi rimuoverli — vengono deduplicati automaticamente, quindi mantenerli è innocuo. Usa `routing.enableProxy: false` per disattivare il proxy.
 - **Locales & Dialects**: Se utilizzi dipendenze i18n esterne, aggiungi i rispettivi compat adapter plugin nella tua configurazione o setup del bundler per riscrivere automaticamente gli import.
 - **Custom Selectors**: Quando chiami `useIntlayer`, il secondo parametro è ora riservato a un oggetto di opzioni contenente `{ locale, item, variant }`. Se in precedenza passavi direttamente una stringa locale, puoi ancora farlo, ma l'utilizzo dell'oggetto di opzioni è consigliato per selezioni avanzate.
+- **React Native**: `react-native-intlayer` ora riesporta l'intera API di `react-intlayer`. In un'app React Native, importa tutto da `react-native-intlayer` e rimuovi la dipendenza diretta da `react-intlayer`. Gli import esistenti di `react-intlayer` continuano a funzionare.
 
 ---
 
@@ -310,4 +405,7 @@ Se stai eseguendo l'aggiornamento da v8, nota che la v9 non include breaking cha
 
 - [Guida ai Compat Adapter Packages](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/index.md)
 - [Dizionari Dinamici - Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/index.md)
+- [Analytics - Tracciamento dell'esposizione dei contenuti e test A/B](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [Riferimento alla Configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md)
+- [SDK CMS - Accesso programmatico con @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md)
+- [Guida al Self-Hosting](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/self_hosting.md)