@intlayer/docs 9.0.0-canary.9 → 9.0.0

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=ia6JmVf-kkU
 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/ia6JmVf-kkU"
+  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)

package/docs/it/self_hosting.md

@@ -0,0 +1,350 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: Self-Hosting Intlayer
+description: Esegui un'istanza Intlayer completa sulla tua infrastruttura con un singolo comando. Non è richiesto alcun account Intlayer Cloud.
+keywords:
+  - Self-Hosting
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Installation
+  - Infrastructure
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Self-Hosting Intlayer
+
+Intlayer può essere eseguito interamente sulla tua infrastruttura — non è richiesto alcun account Intlayer Cloud. Un singolo comando avvia uno stack pronto per la produzione:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+L'installer scarica un `docker-compose.yml` e un `.env`, genera automaticamente i segreti richiesti e avvia tutti i container con `docker compose up -d`.
+
+## Indice dei Contenuti
+
+<TOC/>
+
+---
+
+## Architettura
+
+```
+                ┌─────────────────────────────┐
+ browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  backend (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (1-node RS)             (S3 API)     (SMTP)        (in-image)
+                             minio:9001   mailpit:8025
+                             (console)    (web UI)
+```
+
+Chromium (utilizzato per la generazione di screenshot con Puppeteer) è incluso nell'immagine del backend — non è necessario un container separato.
+
+---
+
+## Prerequisiti
+
+- **Docker** ≥ 24 e **Docker Compose** ≥ v2. Se uno dei due manca, l'installer stampa il link di installazione ed esce.
+- Porte `3000`, `3100`, `8025`, `9000` e `9001` disponibili sull'host.
+- Un host Linux o macOS (o WSL2 su Windows).
+
+---
+
+## Avvio rapido
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Cosa fa l'installer:
+
+1.  Verifica che `docker` e `docker compose` siano presenti.
+2.  Scarica `docker-compose.yml` e `.env.example` in `./intlayer/`.
+3.  Se non esiste un `.env`, copia l'esempio e genera segreti casuali per `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` e `S3_SECRET_ACCESS_KEY` tramite `openssl rand`.
+4.  Esegue `docker compose pull` + `docker compose up -d`.
+5.  Stampa gli URL: dashboard `:3000`, API `:3100`, interfaccia utente email `:8025`, console MinIO `:9001`.
+
+Dopo che lo stack è attivo, apri **http://localhost:3000** e crea il tuo primo account.
+
+---
+
+## Servizi
+
+| Servizio    | Immagine                             | Porta/e host                   | Scopo                                                         |
+| ----------- | ------------------------------------ | ------------------------------ | ------------------------------------------------------------- |
+| **app**     | built from `apps/app/Dockerfile`     | `3000`                         | Dashboard TanStack Start (UI del CMS)                         |
+| **backend** | built from `apps/backend/Dockerfile` | `3100`                         | API REST Fastify (endpoint `/health`)                         |
+| **mongo**   | `mongo:7`                            | internal                       | Replica set a nodo singolo (`rs0`)                            |
+| **redis**   | `redis:7-alpine`                     | internal                       | Code di lavoro (BullMQ) e caching (ioredis)                   |
+| **minio**   | `minio/minio`                        | `9000` (S3), `9001` (console)  | Storage di oggetti compatibile con S3 per avatar e screenshot |
+| **mailpit** | `axllent/mailpit`                    | `1025` (SMTP), `8025` (web UI) | Sink di email transazionali locale                            |
+
+Le porte interne (mongo, redis) non sono esposte all'host per impostazione predefinita.
+
+> La porta `9000` di MinIO deve essere raggiungibile dal browser perché gli asset caricati (avatar, screenshot) vengono caricati direttamente da `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
+
+---
+
+## Variabili d'ambiente
+
+L'installer genera un `.env` pronto all'uso. La tabella seguente descrive ogni variabile.
+
+### Obbligatorie (generate automaticamente o richieste)
+
+| Variabile              | Esempio                                         | Descrizione                                                             |
+| ---------------------- | ----------------------------------------------- | ----------------------------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | Ambiente di runtime                                                     |
+| `PORT`                 | `3100`                                          | Porta di ascolto del backend                                            |
+| `BACKEND_URL`          | `http://localhost:3100`                         | URL pubblico dell'API del backend                                       |
+| `APP_URL`              | `http://localhost:3000`                         | URL pubblico della dashboard                                            |
+| `DOMAIN`               | `localhost`                                     | Dominio del cookie                                                      |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | URI di connessione completo di MongoDB                                  |
+| `REDIS_URL`            | `redis://redis:6379`                            | URL di connessione di Redis                                             |
+| `BETTER_AUTH_SECRET`   | _(generated)_                                   | Segreto di 32 byte per la firma della sessione                          |
+| `MAIL_PROVIDER`        | `smtp`                                          | Trasporto email: `smtp` o `resend`                                      |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | Hostname SMTP (nome del container Mailpit)                              |
+| `MAIL_SMTP_PORT`       | `1025`                                          | Porta SMTP                                                              |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Indirizzo del mittente                                                  |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | Endpoint compatibile con S3                                             |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | URL pubblico per il caricamento degli asset del browser                 |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Nome del bucket                                                         |
+| `S3_ACCESS_KEY_ID`     | _(generated)_                                   | Chiave di accesso MinIO                                                 |
+| `S3_SECRET_ACCESS_KEY` | _(generated)_                                   | Chiave segreta MinIO                                                    |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | URL del backend integrato nella dashboard al momento della compilazione |
+| `VITE_DOMAIN`          | `localhost`                                     | Dominio integrato nella dashboard al momento della compilazione         |
+
+### Opzionali (le funzionalità degradano elegantemente se assenti)
+
+| Variabile                                                | Funzionalità                                                              |
+| -------------------------------------------------------- | ------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | Traduzione assistita da AI e audit del contenuto                          |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Gestione della fatturazione e degli abbonamenti                           |
+| `RESEND_API_KEY`                                         | Email transazionali tramite Resend (sostituisce Mailpit quando impostato) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | Accesso OAuth di GitHub                                                   |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Accesso OAuth di Google                                                   |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | Accesso OAuth di GitLab                                                   |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Accesso OAuth di Microsoft                                                |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Accesso OAuth di LinkedIn                                                 |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Accesso OAuth di Atlassian                                                |
+
+---
+
+## Collegamento del tuo progetto Intlayer
+
+Una volta che lo stack è in esecuzione, punta il tuo progetto al backend e alla dashboard self-hosted invece di `intlayer.org`.
+
+### Configurazione del progetto
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+
+    /**
+     * URL della dashboard CMS self-hosted.
+     * Predefinito: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000
+
+    /**
+     * URL dell'API del backend self-hosted.
+     * Predefinito: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Imposta le variabili d'ambiente nel `.env` del tuo progetto:
+
+```sh
+INTLAYER_CMS_URL=http://localhost:3000
+INTLAYER_BACKEND_URL=http://localhost:3100
+INTLAYER_CLIENT_ID=<your-client-id>
+INTLAYER_CLIENT_SECRET=<your-client-secret>
+```
+
+Crea le credenziali di accesso nella tua dashboard self-hosted sotto **Progetti → Chiavi di accesso** all'indirizzo `http://localhost:3000/projects`.
+
+### SDK `@intlayer/api`
+
+Quando si utilizza l'SDK `@intlayer/api` in modo programmatico, passa `backendURL` esplicitamente:
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cms = createIntlayerCMS({
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100
+  },
+});
+
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+```
+
+---
+
+## Aggiornamento
+
+Eseguire nuovamente l'installer su un'implementazione esistente esegue un aggiornamento rolling:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Questo scarica le immagini più recenti e riavvia i container con `docker compose pull && docker compose up -d`. I volumi esistenti (`mongo-data`, `redis-data`, `minio-data`) vengono preservati — nessuna perdita di dati.
+
+Per aggiornare manualmente dalla directory `./intlayer/`:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Backup e ripristino
+
+Tutti i dati persistenti risiedono in tre volumi Docker nominati.
+
+### Backup
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/mongo-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_redis-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/redis-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_minio-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/minio-data.tar.gz /data
+```
+
+### Ripristino
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# Ripetere per redis-data e minio-data
+```
+
+---
+
+## Utilizzo di un reverse proxy (Nginx / Caddy)
+
+Per le implementazioni in produzione, posiziona un reverse proxy davanti ai container dell'app e del backend invece di esporli direttamente.
+
+### Esempio Nginx
+
+```nginx
+server {
+    listen 80;
+    server_name cms.example.com;
+
+    location / {
+        proxy_pass http://localhost:3000;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+
+server {
+    listen 80;
+    server_name api.example.com;
+
+    location / {
+        proxy_pass http://localhost:3100;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+Aggiorna le seguenti variabili `.env` per corrispondere ai tuoi domini pubblici:
+
+```sh
+BACKEND_URL=https://api.example.com
+APP_URL=https://cms.example.com
+DOMAIN=example.com
+VITE_BACKEND_URL=https://api.example.com
+VITE_DOMAIN=example.com
+```
+
+> Le variabili `VITE_*` sono integrate nell'immagine della dashboard al momento della compilazione. Se le modifichi dopo che l'immagine è stata compilata, devi ricostruire l'immagine `app` (`docker compose build app`) o utilizzare l'iniezione della configurazione a runtime.
+
+---
+
+## Risoluzione dei problemi
+
+### Il backend si riavvia in loop al primo avvio
+
+MongoDB e Redis devono essere sani prima che il backend si avvii. Il file compose utilizza `depends_on` con `condition: service_healthy`. Se vedi ripetuti riavvii del backend, verifica che i controlli di integrità di `mongo` e `redis` passino:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### La dashboard non riesce a raggiungere l'API
+
+Verifica che `VITE_BACKEND_URL` corrisponda all'URL dove il backend è raggiungibile dal **browser** (non dalla rete Docker). Se hai cambiato la porta del backend o aggiunto un reverse proxy, ricostruisci l'immagine della dashboard:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### Email non inviate
+
+Per impostazione predefinita, tutte le email in uscita vengono catturate da Mailpit. Apri `http://localhost:8025` per vedere i messaggi inviati. Per inviare email reali, imposta `MAIL_PROVIDER=resend` e `RESEND_API_KEY=<la-tua-chiave>` in `.env`, quindi riavvia il backend:
+
+```sh
+docker compose restart backend
+```
+
+### Bucket MinIO mancante
+
+Se il servizio one-shot `minio-init` non è stato eseguito (o è stato eseguito prima che MinIO fosse pronto), crea il bucket manualmente:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Link utili
+
+- [Documentazione Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md)
+- [Riferimento alla configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md)
+- [SDK CMS — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md#programmatic-access-con-l-sdk-intlayerapi)
+- [Docker Image (aymercizip/intlayer-selfhost)](https://hub.docker.com/repository/docker/aymercizip/intlayer-selfhost/general)

package/docs/ja/bundle_optimization.md

@@ -231,6 +231,9 @@ Next.jsはビルドにSWCを使用するため、最適化（インポートの
 
 > SWCプラグインはNext.jsではまだ実験的であるため、このプラグインはデフォルトではインストールされません。将来的に変更される可能性があります。
 
+<Tabs>
+ <Tab value="npm">
+
 ```bash packageManager="npm"
 npm install -D @intlayer/swc
 ```
@@ -247,6 +250,19 @@ pnpm add -D @intlayer/swc
 bun add -d @intlayer/swc
 ```
 
+ </Tab>
+ <Tab value="Crates.io (rust)">
+
+```toml fileName="Cargo.toml"
+[dependencies]
+intlayer-swc-plugin = "*"
+```
+
+[View on Crates.io](https://crates.io/crates/intlayer-swc-plugin)
+
+ </Tab>
+</Tabs>
+
 インストールされると、Intlayerはプラグインを自動的に検出して使用します。
 
 **purgeおよびminify**パス（フィールドの削除とフィールドの名前変更）については、一緒に `@intlayer/babel` をインストールし、Babelプラグインを追加します。Next.jsは変換にSWCを使用しますが、プラグイン設定のために `babel.config.js` を評価するため、BabelプラグインはSWCの前の事前パスとして実行されます。

package/docs/ja/cli/index.md

@@ -125,7 +125,7 @@ Intlayerは、複数の設定ファイル形式をサポートしています：
 
 ### 認証
 
-- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/login.md)** - Intlayer CMSで認証し、アクセス資格情報を取得します。
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/login.md)** - Intlayer CMSで認証し、アクセス資格情報を取得します。
 
 ### コアコマンド
 

package/docs/ja/cli/scan.md

@@ -150,10 +150,10 @@ await scan("https://example.com", {
 });
 ```
 
-より低レベルのアクセスには、`@intlayer/chokidar/scan` の `scanWebsite` が構造化された `ScanResult` オブジェクトを返します：
+より低レベルのアクセスには、`@intlayer/engine/scan` の `scanWebsite` が構造化された `ScanResult` オブジェクトを返します：
 
 ```ts
-import { scanWebsite } from "@intlayer/chokidar/scan";
+import { scanWebsite } from "@intlayer/engine/scan";
 
 const result = await scanWebsite("https://example.com", { deep: false });
 console.log(result.score, result.totalPageSize, result.events);