@intlayer/docs 5.5.10 → 5.5.12

package/docs/it/introduction.md

@@ -0,0 +1,209 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-06-29
+title: Introduzione
+description: Scopri come funziona Intlayer. Vedi i passaggi utilizzati da Intlayer nella tua applicazione. Scopri cosa fanno i diversi pacchetti.
+keywords:
+  - Introduzione
+  - Iniziare
+  - Intlayer
+  - Applicazione
+  - Pacchetti
+slugs:
+  - doc
+  - get-started
+---
+
+# Documentazione di Intlayer
+
+Benvenuto nella documentazione ufficiale di Intlayer! Qui troverai tutto ciò di cui hai bisogno per integrare, configurare e padroneggiare Intlayer per tutte le tue esigenze di internazionalizzazione (i18n), che tu stia lavorando con Next.js, React, Vite, Express o un altro ambiente JavaScript.
+
+## Introduzione
+
+### Cos'è Intlayer?
+
+**Intlayer** è una libreria di internazionalizzazione progettata specificamente per gli sviluppatori JavaScript. Permette la dichiarazione dei tuoi contenuti ovunque nel tuo codice. Converte la dichiarazione di contenuti multilingue in dizionari strutturati per integrarsi facilmente nel tuo codice. Utilizzando TypeScript, **Intlayer** rende il tuo sviluppo più solido ed efficiente.
+
+Intlayer fornisce anche un editor visivo opzionale che ti consente di modificare e gestire facilmente i tuoi contenuti. Questo editor è particolarmente utile per gli sviluppatori che preferiscono un'interfaccia visiva per la gestione dei contenuti, o per i team che generano contenuti senza doversi preoccupare del codice.
+
+### Esempio di utilizzo
+
+```bash
+.
+└── Components
+    └── MyComponent
+        ├── index.content.cjs
+        └── index.mjs
+```
+
+```tsx fileName="src/components/MyComponent/index.content.ts" contentDeclarationFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+} satisfies Dictionary;
+
+export default componentContent;
+```
+
+```javascript fileName="src/components/MyComponent/index.content.mjs" contentDeclarationFormat="esm"
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+// Contenuto del componente con traduzioni multilingue
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+};
+
+export default componentContent;
+```
+
+```javascript fileName="src/components/MyComponent/index.content.cjs" contentDeclarationFormat="commonjs"
+const { t } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+// Contenuto del componente con traduzioni multilingue
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+};
+
+module.exports = componentContent;
+```
+
+```json fileName="src/components/MyComponent/index.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "component-key",
+  "content": {
+    "myTranslatedContent": {
+      "nodeType": "translation",
+      "translation": {
+        "en": "Hello World",
+        "fr": "Bonjour le monde",
+        "es": "Hola Mundo"
+      }
+    }
+  }
+}
+```
+
+```tsx fileName="src/components/MyComponent/index.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+export const MyComponent: FC = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="src/components/MyComponent/index.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="src/components/MyComponent/index.csx" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+## Funzionalità Principali
+
+Intlayer offre una varietà di funzionalità progettate per soddisfare le esigenze dello sviluppo web moderno. Di seguito sono riportate le caratteristiche principali, con link alla documentazione dettagliata per ciascuna:
+
+- **Supporto per l'Internazionalizzazione**: Migliora la portata globale della tua applicazione con il supporto integrato per l'internazionalizzazione.
+- **Editor Visivo**: Migliora il tuo flusso di lavoro di sviluppo con i plugin per editor progettati per Intlayer. Consulta la [Guida all'Editor Visivo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md).
+- **Flessibilità di Configurazione**: Personalizza la tua configurazione con ampie opzioni dettagliate nella [Guida alla Configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md).
+- **Strumenti CLI Avanzati**: Gestisci i tuoi progetti in modo efficiente utilizzando l'interfaccia a riga di comando di Intlayer. Esplora le funzionalità nella [Documentazione degli Strumenti CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_cli.md).
+
+## Concetti Fondamentali
+
+### Dizionario
+
+Organizza i tuoi contenuti multilingue vicino al codice per mantenere tutto coerente e facilmente gestibile.
+
+- **[Inizia Qui](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/get_started.md)**  
+  Impara le basi per dichiarare i tuoi contenuti in Intlayer.
+
+- **[Traduzione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/translation.md)**  
+  Comprendi come le traduzioni vengono generate, memorizzate e utilizzate nella tua applicazione.
+
+- **[Enumerazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/enumeration.md)**  
+  Gestisci facilmente insiemi di dati ripetuti o fissi in diverse lingue.
+
+- **[Condizione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/conditional.md)**  
+  Impara a usare la logica condizionale in Intlayer per creare contenuti dinamici.
+
+- **[Inserimento](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/insertion.md)**  
+  Scopri come inserire valori in una stringa usando segnaposto di inserimento.
+
+- **[Recupero Funzioni](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/function_fetching.md)**  
+  Scopri come recuperare dinamicamente contenuti con logiche personalizzate per adattarsi al flusso di lavoro del tuo progetto.
+
+- **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/markdown.md)**  
+  Impara a usare Markdown in Intlayer per creare contenuti ricchi.
+
+- **[Incorporamento File](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/file_embeddings.md)**  
+  Scopri come incorporare file esterni in Intlayer per usarli nell’editor di contenuti.
+
+- **[Annidamento](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/nesting.md)**  
+  Comprendi come annidare contenuti in Intlayer per creare strutture complesse.
+
+### Ambienti e Integrazioni
+
+Abbiamo progettato Intlayer con la flessibilità in mente, offrendo un'integrazione senza soluzione di continuità con i framework e gli strumenti di build più popolari:
+
+- **[Intlayer con Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_nextjs_15.md)**
+- **[Intlayer con Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_nextjs_14.md)**
+- **[Intlayer con Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_nextjs_page_router.md)**
+- **[Intlayer con React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_create_react_app.md)**
+- **[Intlayer con Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_vite+react.md)**
+- **[Intlayer con React Native e Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_react_native+expo.md)**
+- **[Intlayer con Lynx e React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_lynx+react.md)**
+- **[Intlayer con Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_express.md)**
+
+Ogni guida all'integrazione include le migliori pratiche per utilizzare le funzionalità di Intlayer, come il **rendering lato server**, il **routing dinamico** o il **rendering lato client**, così da poter mantenere un'applicazione veloce, ottimizzata per i motori di ricerca (SEO) e altamente scalabile.
+
+## Contributi e Feedback
+
+Valorizziamo il potere dell'open-source e dello sviluppo guidato dalla comunità. Se desideri proporre miglioramenti, aggiungere una nuova guida o correggere eventuali problemi nella nostra documentazione, sentiti libero di inviare una Pull Request o aprire un issue nel nostro [repository GitHub](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
+
+**Pronto a tradurre la tua applicazione in modo più rapido ed efficiente?** Immergiti nella nostra documentazione per iniziare a usare Intlayer oggi stesso. Vivi un approccio robusto e semplificato all'internazionalizzazione che mantiene i tuoi contenuti organizzati e il tuo team più produttivo.
+
+---
+
+## Cronologia della documentazione
+
+- 5.5.10 - 2025-06-29: Inizio cronologia

package/docs/it/mcp_server.md

@@ -0,0 +1,174 @@
+---
+createdAt: 2025-06-07
+updatedAt: 2025-06-07
+title: Documentazione del Server MCP
+description: Esplora le funzionalità e la configurazione del Server MCP per ottimizzare la gestione e le operazioni del tuo server.
+keywords:
+  - Server MCP
+  - Gestione Server
+  - Ottimizzazione
+  - Intlayer
+  - Documentazione
+  - Configurazione
+  - Funzionalità
+slugs:
+  - doc
+  - mcp-server
+---
+
+# Server MCP di Intlayer
+
+Il **Server Intlayer MCP (Model Context Protocol)** fornisce assistenza IDE potenziata dall'IA, progettata specificamente per l'ecosistema Intlayer. Ideato per ambienti di sviluppo moderni come **Cursor**, **GitHub Copilot workspace** e qualsiasi IDE che supporti il protocollo MCP, questo server ti offre supporto contestuale e in tempo reale basato sulla configurazione del tuo progetto.
+
+## Perché usare il Server Intlayer MCP?
+
+Abilitando il Server Intlayer MCP nel tuo IDE, potrai usufruire di:
+
+- **Integrazione intelligente della CLI**
+  Accedi ed esegui i comandi della CLI Intlayer direttamente dall'interfaccia del tuo IDE. Visualizza l'elenco completo dei comandi e delle opzioni nella [documentazione della CLI Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_cli.md).
+
+- **Documentazione contestuale**
+  Il server MCP carica ed espone la documentazione corrispondente alla versione di Intlayer che stai utilizzando nel tuo progetto. Questo garantisce che i suggerimenti di codice, le opzioni dei comandi e le spiegazioni siano sempre aggiornati e pertinenti.
+
+- **Sviluppo assistito dall'IA**
+  Con suggerimenti e completamento automatico consapevoli del progetto, l'assistente IA può spiegare il tuo codice, consigliare l'uso della CLI o suggerire come utilizzare funzionalità specifiche di Intlayer basandosi sui file attuali.
+
+- **Leggero e configurazione istantanea**
+  Nessuna manutenzione del server o installazione pesante richiesta. Basta configurare il file `.cursor/mcp.json` o un equivalente file di configurazione MCP e sei pronto per partire.
+
+---
+
+## Configurazione di Cursor
+
+Nella radice del tuo progetto, aggiungi il seguente file di configurazione `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+Questo indica al tuo IDE di avviare il server MCP di Intlayer utilizzando `npx`, assicurandosi che venga sempre usata la versione più recente disponibile a meno che tu non la blocchi.
+
+---
+
+## Configurare VS Code
+
+Per utilizzare il server MCP di Intlayer con VS Code, devi configurarlo nelle impostazioni del workspace o dell'utente.
+
+### Configurazione del Workspace
+
+Crea un file `.vscode/mcp.json` nella radice del tuo progetto:
+
+```json
+{
+  "servers": {
+    "intlayer": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+### Utilizzo del server MCP in VS Code
+
+1. **Abilita la modalità Agent**: Apri la vista Chat (⌃⌘I su Mac, Ctrl+Alt+I su Windows/Linux) e seleziona la modalità **Agent** dal menu a tendina.
+
+2. **Accedi agli Strumenti**: Clicca sul pulsante **Strumenti** per visualizzare gli strumenti Intlayer disponibili. Puoi selezionare/deselezionare strumenti specifici secondo necessità.
+
+3. **Riferimento Diretto agli Strumenti**: Fai riferimento agli strumenti direttamente nei tuoi prompt digitando `#` seguito dal nome dello strumento.
+
+4. **Conferma degli Strumenti**: Per impostazione predefinita, VS Code chiederà conferma prima di eseguire gli strumenti. Usa le opzioni del pulsante **Continua** per confermare automaticamente gli strumenti per la sessione corrente, il workspace o tutte le invocazioni future.
+
+### Gestione del Server
+
+- Esegui **MCP: Elenca Server** dalla Command Palette per visualizzare i server configurati
+- Avvia, ferma o riavvia il server MCP di Intlayer secondo necessità
+- Visualizza i log del server per la risoluzione dei problemi selezionando il server e scegliendo **Mostra Output**
+
+Per maggiori informazioni sull'integrazione MCP in VS Code, consulta la [documentazione ufficiale MCP di VS Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).
+
+---
+
+## Utilizzo del Server MCP tramite CLI
+
+Puoi anche eseguire il server MCP di Intlayer direttamente dalla riga di comando per test, debug o integrazione con altri strumenti.
+
+### Installare il Server MCP
+
+Per prima cosa, installa il pacchetto del server MCP globalmente oppure usalo tramite npx:
+
+```bash
+# Installa globalmente
+npm install -g @intlayer/mcp
+
+# Oppure usa direttamente con npx (consigliato)
+npx @intlayer/mcp
+```
+
+### Avviare il Server
+
+Per avviare il server MCP con l'inspector per il debug e i test:
+
+```bash
+# Usando il comando start integrato
+npm run start
+
+# Oppure direttamente con npx
+npx @modelcontextprotocol/inspector npx @intlayer/mcp
+```
+
+Questo avvierà il server MCP con un'interfaccia inspector che ti permette di:
+
+- Testare le comunicazioni del protocollo MCP
+- Eseguire il debug delle risposte del server
+- Validare le implementazioni di strumenti e risorse
+- Monitorare le prestazioni del server
+
+### Uso per lo Sviluppo
+
+Per scopi di sviluppo e test, puoi eseguire il server in diverse modalità:
+
+```bash
+# Compila e avvia in modalità sviluppo
+npm run dev
+
+# Esegui con configurazione personalizzata
+node dist/cjs/index.cjs
+
+# Testa la funzionalità del server
+npm test
+```
+
+Il server esporrà strumenti e risorse specifici di Intlayer che possono essere utilizzati da qualsiasi client compatibile con MCP, non solo da Cursor o altri IDE.
+
+---
+
+## Panoramica delle Funzionalità
+
+| Feature                   | Description                                                                                             |
+| ------------------------- | ------------------------------------------------------------------------------------------------------- |
+| Supporto CLI              | Esegui comandi `intlayer`, ottieni suggerimenti sull'uso e argomenti inline                             |
+| Documentazione Versionata | Rileva automaticamente e carica la documentazione corrispondente alla tua versione corrente di Intlayer |
+| Completamento Automatico  | Suggerimenti intelligenti per comandi e configurazioni mentre digiti                                    |
+| Pronto per Plugin         | Compatibile con IDE e strumenti che supportano lo standard MCP                                          |
+
+---
+
+## Link Utili
+
+- [Documentazione CLI di Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_cli.md)
+- [Repository GitHub di Intlayer](https://github.com/aymericzip/intlayer)
+
+---
+
+## Cronologia Documentazione
+
+- 5.5.10 - 2025-06-29: Inizio cronologia

package/docs/it/packages/@intlayer/api/index.md

@@ -0,0 +1,56 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/api - SDK per l'integrazione con l'API di Intlayer
+description: Pacchetto NPM che fornisce un Software Development Kit (SDK) per interagire con l'API di Intlayer per il controllo dei contenuti, organizzazioni, progetti e gestione utenti.
+keywords:
+  - intlayer
+  - API
+  - SDK
+  - integrazione
+  - controllo contenuti
+  - organizzazioni
+  - progetti
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - api
+---
+
+# @intlayer/api: Pacchetto NPM per interagire con l'API di Intlayer
+
+**Intlayer** è una suite di pacchetti progettata specificamente per sviluppatori JavaScript. È compatibile con framework come React, React e Express.js.
+
+**Il pacchetto `@intlayer/api` è un SDK (Software Development Kit) per interagire con l'API di Intlayer. Fornisce un insieme di funzioni per controllare la dichiarazione dei contenuti, interagire con organizzazioni, progetti e utenti, ecc.**
+
+## Utilizzo
+
+```ts
+import { intlayerAPI } from "@intlayer/api";
+
+intlayerAPI.user.getUser({
+  ids: ["user-id-1", "user-id-2"],
+});
+```
+
+## Installazione
+
+Installa il pacchetto necessario utilizzando il tuo gestore di pacchetti preferito:
+
+```bash packageManager="npm"
+npm install @intlayer/api
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/api
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/api
+```
+
+## Cronologia della documentazione
+
+- 5.5.10 - 2025-06-29: Inizio cronologia

package/docs/it/packages/@intlayer/chokidar/index.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/chokidar - Monitoraggio file per l'i18n di Intlayer
+description: Pacchetto NPM che fornisce funzionalità di monitoraggio file per Intlayer, abilitando aggiornamenti automatici e hot reload per i contenuti di internazionalizzazione.
+keywords:
+  - intlayer
+  - chokidar
+  - monitoraggio file
+  - hot reload
+  - i18n
+  - JavaScript
+  - NPM
+  - sviluppo
+slugs:
+  - doc
+  - package
+  - @intlayer_chokidar
+---
+
+# @intlayer/chokidar: Pacchetto NPM per scansionare e costruire file di dichiarazione Intlayer in dizionari
+
+**Intlayer** è una suite di pacchetti progettata specificamente per sviluppatori JavaScript. È compatibile con framework come React, React e Express.js.
+
+Il pacchetto **`@intlayer/chokidar`** viene utilizzato per scansionare e costruire i file di dichiarazione Intlayer in dizionari utilizzando [chokidar](https://github.com/paulmillr/chokidar) e secondo la [configurazione di Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md).
+
+## Utilizzo
+
+```ts
+import { watch, prepareIntlayer } from "@intlayer/chokidar";
+
+await prepareIntlayer(); // Costruisci i dizionari di Intlayer
+
+watch({ persistent: true }); // Monitora le modifiche nei file di configurazione
+```
+
+## Installazione
+
+Installa il pacchetto necessario utilizzando il tuo gestore di pacchetti preferito:
+
+```bash packageManager="npm"
+npm install @intlayer/chokidar
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/chokidar
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/chokidar
+```
+
+## Cronologia della documentazione
+
+- 5.5.10 - 2025-06-29: Storia iniziale

package/docs/it/packages/@intlayer/cli/index.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/cli - Pacchetto Interfaccia a Riga di Comando per Intlayer
+description: Pacchetto NPM che fornisce script per i comandi CLI di Intlayer, garantendo uniformità in tutte le interfacce a riga di comando per la gestione dell'internazionalizzazione.
+keywords:
+  - intlayer
+  - CLI
+  - riga di comando
+  - script
+  - i18n
+  - JavaScript
+  - NPM
+  - strumenti
+slugs:
+  - doc
+  - package
+  - @intlayer_cli
+---
+
+# @intlayer/cli: Pacchetto NPM per utilizzare gli script forniti dalla CLI di intlayer
+
+**Intlayer** è una suite di pacchetti progettata specificamente per sviluppatori JavaScript. È compatibile con framework come React, React e Express.js.
+
+Il pacchetto **`@intlayer/cli`** è un pacchetto NPM utilizzato per dichiarare gli script relativi alle interfacce a riga di comando dei comandi intlayer. Garantisce l'uniformità di tutti i comandi CLI di intlayer. Questo pacchetto è in particolare utilizzato dai pacchetti [intlayer-cli](https://github.com/aymericzip/intlayer/tree/main/docs/docs/it/packages/intlayer-cli/index.md) e [intlayer](https://github.com/aymericzip/intlayer/tree/main/docs/docs/it/packages/intlayer/index.md).
+
+## Installazione
+
+Installa il pacchetto necessario utilizzando il tuo gestore di pacchetti preferito:
+
+```bash packageManager="npm"
+npm install @intlayer/cli
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/cli
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/cli
+```
+
+## Cronologia della documentazione
+
+- 5.5.10 - 2025-06-29: Inizio cronologia

package/docs/it/packages/@intlayer/config/index.md

@@ -0,0 +1,140 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/config - Gestione della Configurazione per Intlayer
+description: Pacchetto NPM per recuperare la configurazione di Intlayer e definire le variabili d'ambiente per le impostazioni di internazionalizzazione in diversi ambienti.
+keywords:
+  - intlayer
+  - configurazione
+  - ambiente
+  - impostazioni
+  - i18n
+  - JavaScript
+  - NPM
+  - variabili
+slugs:
+  - doc
+  - package
+  - @intlayer_config
+---
+
+# @intlayer/config: Pacchetto NPM per recuperare la configurazione di Intlayer
+
+**Intlayer** è una suite di pacchetti progettata specificamente per sviluppatori JavaScript. È compatibile con framework come React, React e Express.js.
+
+Il pacchetto **`@intlayer/config`** è un pacchetto NPM che consente di recuperare la configurazione di Intlayer e definire le variabili d'ambiente relative all'ambiente corrente.
+
+## Installazione
+
+Installa il pacchetto necessario utilizzando il tuo gestore di pacchetti preferito:
+
+```bash packageManager="npm"
+npm install @intlayer/config
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/config
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/config
+```
+
+## Utilizzo
+
+### Leggere la configurazione di Intlayer usando il file system
+
+Esempio:
+
+```ts
+import { getConfiguration, type IntlayerConfig } from "@intlayer/config";
+
+const config: IntlayerConfig = getConfiguration();
+
+console.log(config);
+// Output:
+// {
+//   internationalization: { ... },
+//   middleware: { ... },
+//   content: { ... },
+//   editor: { ... }
+// }
+```
+
+> Questa funzione utilizza i pacchetti `fs` e funzionerà solo lato server.
+
+### Leggere la configurazione di Intlayer utilizzando le variabili d'ambiente
+
+Esempio:
+
+```ts
+import { getConfiguration, type IntlayerConfig } from "@intlayer/config/client";
+
+const config: IntlayerConfig = getConfiguration({
+  env: "production",
+});
+
+console.log(config);
+// Output:
+// {
+//   internationalization: { ... },
+//   middleware: { ... },
+//   content: { ... },
+//   editor: { ... }
+// }
+```
+
+> Questa funzione non restituirà nulla se le variabili d'ambiente non sono definite.
+
+### Definire le variabili d'ambiente
+
+1. Crea un file di configurazione.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    /* ... */
+  },
+  middleware: {
+    /* ... */
+  },
+  content: {
+    /* ... */
+  },
+  editor: {
+    /* ... */
+  },
+};
+
+export default config;
+```
+
+> Consulta la [documentazione della configurazione di Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md) per maggiori dettagli.
+
+2. Definisci le variabili d'ambiente.
+
+```ts
+import { getConfiguration } from "@intlayer/config";
+
+const intlayerConfig = getConfiguration();
+
+// Format all configuration values as environment variables
+const env = formatEnvVariable();
+
+// Set each formatted environment variable in process.env
+Object.assign(process.env, env);
+```
+
+3. Importa il file di configurazione.
+
+```ts
+import { getConfiguration } from "@intlayer/config/client";
+
+const intlayerConfig = getConfiguration();
+```
+
+## Cronologia del documento
+
+- 5.5.10 - 2025-06-29: Inizio cronologia