@intlayer/docs 7.5.7 → 7.5.9

package/docs/it/cli/init.md

@@ -0,0 +1,97 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2025-12-30
+title: Inizializzare Intlayer
+description: Scopri come inizializzare Intlayer nel tuo progetto.
+keywords:
+  - Inizializzare
+  - CLI
+  - Intlayer
+  - AI
+slugs:
+  - doc
+  - concept
+  - cli
+  - init
+history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Aggiunta del comando init
+---
+
+# Inizializzare Intlayer
+
+```bash
+npx intlayer init
+```
+
+Il comando `init` configura automaticamente Intlayer nel tuo progetto impostando i file e le configurazioni necessari. È il modo consigliato per iniziare con Intlayer.
+
+## Alias:
+
+- `npx intlayer init`
+
+## Argomenti:
+
+- `--project-root [projectRoot]` - Opzionale. Specifica la directory root del progetto. Se non fornito, il comando cercherà la root del progetto partendo dalla directory di lavoro corrente.
+
+## Cosa fa:
+
+Il comando `init` esegue le seguenti operazioni di configurazione:
+
+1. **Valida la struttura del progetto** - Verifica che tu sia in una directory di progetto valida con un file `package.json`
+2. **Aggiorna `.gitignore`** - Aggiunge `.intlayer` al tuo file `.gitignore` per escludere i file generati dal controllo versione
+3. **Configura TypeScript** - Aggiorna tutti i file `tsconfig.json` per includere le definizioni di tipo di Intlayer (`.intlayer/**/*.ts`)
+4. **Crea il file di configurazione** - Genera un `intlayer.config.ts` (per progetti TypeScript) o `intlayer.config.mjs` (per progetti JavaScript) con impostazioni predefinite
+5. **Aggiorna la configurazione di Vite** - Se viene rilevato un file di configurazione Vite, aggiunge l'import del plugin `vite-intlayer`
+
+Il comando `init` esegue le seguenti attività di configurazione:
+
+1. **Valida la struttura del progetto** - Verifica che ti trovi in una directory di progetto valida contenente un file `package.json`
+2. **Aggiorna `.gitignore`** - Aggiunge `.intlayer` al tuo file `.gitignore` per escludere i file generati dal controllo versione
+3. **Configura TypeScript** - Aggiorna tutti i file `tsconfig.json` per includere le definizioni di tipo di Intlayer (`.intlayer/**/*.ts`)
+4. **Crea il file di configurazione** - Genera un `intlayer.config.ts` (per progetti TypeScript) o `intlayer.config.mjs` (per progetti JavaScript) con impostazioni predefinite
+5. **Aggiorna la configurazione di Vite** - Se viene rilevato un file di configurazione di Vite, aggiunge l'import del plugin `vite-intlayer`
+6. **Aggiorna la configurazione di Next.js** - Se viene rilevato un file di configurazione di Next.js, aggiunge l'import del plugin `next-intlayer`
+
+## Esempi:
+
+### Inizializzazione base:
+
+```bash
+npx intlayer init
+```
+
+Questo inizializzerà Intlayer nella directory corrente, rilevando automaticamente la root del progetto.
+
+### Inizializza con root di progetto personalizzata:
+
+```bash
+npx intlayer init --project-root ./my-project
+```
+
+Questo inizializzerà Intlayer nella directory specificata.
+
+## Output di esempio:
+
+```bash
+npx intlayer init
+Verifica della configurazione di Intlayer...
+✓ Aggiunta di .intlayer a .gitignore
+✓ Aggiornato tsconfig.json per includere i tipi di Intlayer
+Creato intlayer.config.ts
+✓ Import inserito in vite.config.ts
+✓ Configurazione init di Intlayer completata.
+```
+
+## Note:
+
+- Il comando è idempotente: puoi eseguirlo più volte in sicurezza. Salterà i passaggi già configurati.
+- Se un file di configurazione esiste già, non verrà sovrascritto.
+- I file di configurazione TypeScript senza un `include` array (ad es., configurazioni in stile solution con references) vengono ignorati.
+- Il comando terminerà con un errore se non viene trovato alcun `package.json` nella root del progetto.
+
+- Il comando è idempotente - puoi eseguirlo più volte in sicurezza. Salterà i passaggi già configurati.
+- Se esiste già un file di configurazione, non verrà sovrascritto.
+- I file di configurazione TypeScript senza un array `include` (ad es., config in stile solution con references) vengono saltati.
+- Il comando terminerà con un errore se non viene trovato alcun `package.json` nella root del progetto.

package/docs/it/cli/sdk.md

@@ -31,6 +31,10 @@ yarn add @intlayer/cli --save-dev
 pnpm add @intlayer/cli --save-dev
 ```
 
+```bash packageManager="bun"
+bun add @intlayer/cli --dev
+```
+
 Esempio di utilizzo:
 
 ```ts

package/docs/it/intlayer_visual_editor.md

@@ -80,6 +80,10 @@ yarn add intlayer-editor --save-dev
 pnpm add intlayer-editor --save-dev
 ```
 
+```bash packageManager="bun"
+bun add intlayer-editor --dev
+```
+
 ## Configurazione
 
 Nel file di configurazione di Intlayer, puoi personalizzare le impostazioni dell'editor:

package/docs/it/intlayer_with_angular.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2025-06-29
-title: Come tradurre la tua Angular – guida i18n 2025
+updatedAt: 2025-12-30
+title: Come tradurre la tua Angular – guida i18n 2026
 description: Scopri come rendere multilingue il tuo sito web con Angular. Segui la documentazione per internazionalizzarlo (i18n) e tradurlo.
 keywords:
   - Internazionalizzazione
@@ -15,6 +15,9 @@ slugs:
   - angular
 # applicationTemplate: https://github.com/aymericzip/intlayer-angular-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Aggiungi comando init
   - version: 5.5.10
     date: 2025-06-29
     changes: Inizio cronologia
@@ -47,14 +50,22 @@ Installa i pacchetti necessari usando npm:
 
 ```bash packageManager="npm"
 npm install intlayer angular-intlayer @intlayer/webpack
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer angular-intlayer @intlayer/webpack
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer angular-intlayer @intlayer/webpack
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer angular-intlayer @intlayer/webpack
+bunx intlayer init
 ```
 
 - **intlayer**

package/docs/it/intlayer_with_astro.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2025-10-03
-title: Come tradurre la tua Astro – guida i18n 2025
+updatedAt: 2025-12-30
+title: Come tradurre la tua Astro – guida i18n 2026
 description: Scopri come aggiungere l'internazionalizzazione (i18n) al tuo sito web Astro usando Intlayer. Segui questa guida per rendere il tuo sito multilingue.
 keywords:
   - Internazionalizzazione
@@ -17,6 +17,9 @@ slugs:
   - astro
 applicationTemplate: https://github.com/aymericzip/intlayer-astro-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Aggiungi comando init
   - version: 6.2.0
     date: 2025-10-03
     changes: Aggiornamento per integrazione Astro, configurazione, utilizzo

package/docs/it/intlayer_with_create_react_app.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-06-29
-title: Come tradurre la tua Create React App – guida i18n 2025
+updatedAt: 2025-12-30
+title: Come tradurre la tua Create React App – guida i18n 2026
 description: Scopri come rendere il tuo sito Create React App (CRA) multilingue. Segui la documentazione per internazionalizzare (i18n) e tradurlo.
 keywords:
   - Internazionalizzazione
@@ -17,6 +17,9 @@ slugs:
   - create-react-app
 applicationTemplate: https://github.com/aymericzip/intlayer-react-cra-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Aggiungi comando init
   - version: 5.5.10
     date: 2025-06-29
     changes: Cronologia iniziale
@@ -45,14 +48,22 @@ Installa i pacchetti necessari utilizzando npm:
 
 ```bash packageManager="npm"
 npm install intlayer react-intlayer react-scripts-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer react-intlayer react-scripts-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer react-intlayer react-scripts-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer react-intlayer react-scripts-intlayer
+bunx intlayer init
 ```
 
 - **intlayer**

package/docs/it/intlayer_with_express.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-06-29
-title: Come tradurre la tua Express backend – guida i18n 2025
+updatedAt: 2025-12-30
+title: Come tradurre la tua Express backend – guida i18n 2026
 description: Scopri come rendere il tuo backend Express multilingue. Segui la documentazione per internazionalizzare (i18n) e tradurlo.
 keywords:
   - Internazionalizzazione
@@ -15,6 +15,9 @@ slugs:
   - environment
   - express
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Aggiungi comando init
   - version: 5.5.10
     date: 2025-06-29
     changes: Inizializzazione della cronologia
@@ -49,14 +52,22 @@ Per iniziare a utilizzare `express-intlayer`, installa il pacchetto utilizzando
 
 ```bash packageManager="npm"
 npm install intlayer express-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer express-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer express-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer express-intlayer
+bunx intlayer init
 ```
 
 ### Configurazione

package/docs/it/intlayer_with_lynx+react.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-03-09
-updatedAt: 2025-06-29
-title: Come tradurre la tua Lynx and React mobile app – guida i18n 2025
+updatedAt: 2025-12-30
+title: Come tradurre la tua Lynx and React mobile app – guida i18n 2026
 description: Scopri come rendere il tuo sito web che utilizza Lynx e React multilingue. Segui la documentazione per internazionalizzare (i18n) e tradurlo.
 keywords:
   - Internazionalizzazione
@@ -17,6 +17,9 @@ slugs:
   - lynx-and-react
 applicationTemplate: https://github.com/aymericzip/intlayer-lynx-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Aggiungi comando init
   - version: 5.5.10
     date: 2025-06-29
     changes: Inizio cronologia
@@ -45,14 +48,22 @@ Dal tuo progetto Lynx, installa i seguenti pacchetti:
 
 ```bash packageManager="npm"
 npm install intlayer react-intlayer lynx-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer react-intlayer lynx-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer react-intlayer lynx-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer react-intlayer lynx-intlayer
+bunx intlayer init
 ```
 
 ### Pacchetti

package/docs/it/intlayer_with_nestjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2025-09-09
-title: Come tradurre la tua Nest backend – guida i18n 2025
+updatedAt: 2025-12-30
+title: Come tradurre la tua Nest backend – guida i18n 2026
 description: Scopri come rendere il tuo backend NestJS multilingue. Segui la documentazione per internazionalizzare (i18n) e tradurlo.
 keywords:
   - Internazionalizzazione
@@ -17,6 +17,9 @@ slugs:
 applicationTemplate: https://github.com/AydinTheFirst/nestjs-intlayer
 author: AydinTheFirst
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Aggiungi comando init
   - version: 5.8.0
     date: 2025-09-09
     changes: Documentazione iniziale
@@ -59,14 +62,22 @@ Per iniziare a usare `express-intlayer`, installa il pacchetto usando npm:
 
 ```bash packageManager="npm"
 npm install intlayer express-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer express-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer express-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer express-intlayer
+bunx intlayer init
 ```
 
 ### Configurare tsconfig.json

package/docs/it/intlayer_with_next-i18next.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Come tradurre la tua Next.js 15 usando next-i18next – guida i18n 2025
+title: Come tradurre la tua Next.js 15 usando next-i18next – guida i18n 2026
 description: Una guida pratica e pronta per la produzione per internazionalizzare un'app Next.js 15 App Router con i18next/next-i18next e migliorarla con Intlayer.
 keywords:
   - Internazionalizzazione
@@ -57,6 +57,10 @@ pnpm add next-i18next i18next react-i18next i18next-resources-to-backend
 yarn add next-i18next i18next react-i18next i18next-resources-to-backend
 ```
 
+```bash packageManager="bun"
+bun add next-i18next i18next react-i18next i18next-resources-to-backend
+```
+
 Inizia con una struttura chiara. Mantieni i messaggi suddivisi per locale e namespace.
 
 ```bash
@@ -554,14 +558,22 @@ Installa le dipendenze di intlayer:
 
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin --dev
+bunx intlayer init
 ```
 
 ```ts fileName="intlayer.config.ts"

package/docs/it/intlayer_with_next-intl.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Come tradurre il tuo Next.js 15 usando next-intl – guida i18n 2025
+title: Come tradurre il tuo Next.js 15 usando next-intl – guida i18n 2026
 description: Scopri come rendere il tuo sito Next.js 15 App Router multilingue. Segui la documentazione per internazionalizzare (i18n) e tradurlo.
 keywords:
   - Internazionalizzazione
@@ -52,6 +52,10 @@ pnpm add next-intl
 yarn add next-intl
 ```
 
+```bash packageManager="bun"
+bun add next-intl
+```
+
 ```bash
 .
 ├── locales
@@ -402,6 +406,11 @@ yarn add intlayer @intlayer/sync-json-plugin --dev
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
 ```
 
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin --dev
+bunx intlayer init
+```
+
 Crea il file di configurazione di intlayer:
 
 ```tsx fileName="intlayer.config.ts"

package/docs/it/intlayer_with_nextjs_14.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-06-29
-title: Come tradurre la tua Next.js 14 and App Router – guida i18n 2025
+title: Come tradurre la tua Next.js 14 and App Router – guida i18n 2026
 description: Scopri come rendere il tuo sito Next.js 14 App Router multilingue. Segui la documentazione per internazionalizzare (i18n) e tradurlo.
 keywords:
   - Internazionalizzazione
@@ -46,14 +46,22 @@ Installa i pacchetti necessari utilizzando npm:
 
 ```bash packageManager="npm"
 npm install intlayer next-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer next-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer next-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer next-intlayer
+bunx intlayer init
 ```
 
 - **intlayer**
@@ -1248,14 +1256,22 @@ Per abilitare questa ottimizzazione, installa il pacchetto `@intlayer/swc`. Una
 
 ```bash packageManager="npm"
 npm install @intlayer/swc --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add @intlayer/swc --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add @intlayer/swc --save-dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add @intlayer/swc --dev
+bunx intlayer init
 ```
 
 > Nota: Questa ottimizzazione è disponibile solo per Next.js 13 e versioni successive.

package/docs/it/intlayer_with_nextjs_15.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
-updatedAt: 2025-06-29
-title: Come tradurre la tua Next.js 15 – guida i18n 2025
+updatedAt: 2025-12-30
+title: Come tradurre la tua Next.js 15 – guida i18n 2026
 description: Scopri come rendere il tuo sito Next.js 15 multilingue. Segui la documentazione per internazionalizzare (i18n) e tradurlo.
 keywords:
   - Internazionalizzazione
@@ -18,6 +18,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-next-15-template
 youtubeVideo: https://www.youtube.com/watch?v=e_PPG7PTqGU
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Aggiungi comando init
   - version: 5.5.10
     date: 2025-06-29
     changes: Storia iniziale
@@ -53,14 +56,22 @@ Installa i pacchetti necessari usando npm:
 
 ```bash packageManager="npm"
 npm install intlayer next-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer next-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer next-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer next-intlayer
+bunx intlayer init
 ```
 
 - **intlayer**
@@ -1498,14 +1509,22 @@ Per abilitare questa ottimizzazione, installa il pacchetto `@intlayer/swc`. Una
 
 ```bash packageManager="npm"
 npm install @intlayer/swc --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add @intlayer/swc --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add @intlayer/swc --save-dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add @intlayer/swc --dev
+bunx intlayer init
 ```
 
 > Nota: Questa ottimizzazione è disponibile solo per Next.js 13 e versioni successive.

package/docs/it/intlayer_with_nextjs_16.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
-updatedAt: 2025-10-26
-title: Come tradurre la tua app Next.js 16 – Guida i18n 2025
+updatedAt: 2025-12-30
+title: Come tradurre la tua app Next.js 16 – Guida i18n 2026
 description: Scopri come rendere il tuo sito Next.js 16 multilingue. Segui la documentazione per internazionalizzare (i18n) e tradurlo.
 keywords:
   - Internazionalizzazione
@@ -17,6 +17,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-next-16-template
 youtubeVideo: https://www.youtube.com/watch?v=e_PPG7PTqGU
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Aggiungi comando init
   - version: 7.0.0
     date: 2025-06-29
     changes: Inizio cronologia
@@ -73,14 +76,22 @@ Installa i pacchetti necessari usando npm:
 
 ```bash packageManager="npm"
 npm install intlayer next-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer next-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer next-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer next-intlayer
+bunx intlayer init
 ```
 
 - **intlayer**
@@ -1569,14 +1580,22 @@ Per abilitare questa ottimizzazione, installa il pacchetto `@intlayer/swc`. Una
 
 ```bash packageManager="npm"
 npm install @intlayer/swc --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add @intlayer/swc --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add @intlayer/swc --save-dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add @intlayer/swc --dev
+bunx intlayer init
 ```
 
 > Nota: Questa ottimizzazione è disponibile solo per Next.js 13 e versioni successive.

package/docs/it/intlayer_with_nextjs_page_router.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-07
-updatedAt: 2025-06-29
-title: Come tradurre la tua Next.js and Page Router – guida i18n 2025
+updatedAt: 2025-12-30
+title: Come tradurre la tua Next.js and Page Router – guida i18n 2026
 description: Scopri come rendere multilingue il tuo sito Next.js che utilizza Page Router. Segui la documentazione per internazionalizzare (i18n) e tradurlo.
 keywords:
   - Internazionalizzazione
@@ -17,6 +17,9 @@ slugs:
   - nextjs
   - next-with-page-router
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Aggiungi comando init
   - version: 5.5.10
     date: 2025-06-29
     changes: Inizio cronologia
@@ -47,14 +50,22 @@ Installa i pacchetti necessari usando il tuo gestore di pacchetti preferito:
 
 ```bash packageManager="npm"
 npm install intlayer next-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer next-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer next-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer next-intlayer
+bunx intlayer init
 ```
 
 - **intlayer**
@@ -1416,14 +1427,22 @@ Per abilitare questa ottimizzazione, installa il pacchetto `@intlayer/swc`. Una
 
 ```bash packageManager="npm"
 npm install @intlayer/swc --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add @intlayer/swc --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add @intlayer/swc --save-dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add @intlayer/swc --dev
+bunx intlayer init
 ```
 
 > Nota: Questa ottimizzazione è disponibile solo per Next.js 13 e versioni successive.