# gt-react: General Translation React SDK: gt.config.json
URL: https://generaltranslation.com/it/docs/react/api/config/gt-config-json.mdx
---
title: gt.config.json
description: Il file gt.config.json
---

{/* GENERATO AUTOMATICAMENTE: Non modificare direttamente. Modifica invece il template in content/docs-templates/. */}


## Panoramica

Il file `gt.config.json` serve a memorizzare la configurazione del tuo progetto.
Contiene informazioni importanti come il `projectId` del progetto, le impostazioni regionali supportate e altro ancora.
Contiene anche informazioni interne importanti, come il `versionId` del progetto.

Questo file viene letto da (1) il componente [`<GTProvider>`](/docs/react/api/components/gtprovider) e (2) il comando [`gt translate`](/docs/cli/translate).
Per questo motivo, ti consigliamo di salvare la configurazione nel file `gt.config.json` invece di passarla come prop al componente [`<GTProvider>`](/docs/react/api/components/gtprovider).

In generale, tutto ciò che inizia con un trattino basso (ad esempio `_versionId`) è una proprietà interna e non deve essere modificato.
Tutto il resto può essere modificato.

***

## Campi

| Campo               | Tipo       | Descrizione                                                                             |
| ------------------- | ---------- | --------------------------------------------------------------------------------------- |
| `projectId`         | `string`   | Identificatore univoco del progetto nel sistema GT                                      |
| `locales`           | `string[]` | Array dei codici locale supportati dal progetto                                         |
| `defaultLocale`     | `string`   | Codice locale principale usato come fallback quando mancano le traduzioni               |
| `cacheUrl`          | `string`   | Endpoint URL per la cache dei dati di traduzione                                        |
| `runtimeUrl`        | `string`   | Endpoint URL per i servizi di traduzione in runtime                                     |
| `stageTranslations` | `boolean`  | Configurazione per le funzionalità di traduzione in staging/anteprima                   |
| `files`             | `object`   | Percorso dei file di traduzione locali per sviluppo e test                              |
| `_versionId`        | `string`   | Proprietà interna usata per tenere traccia della versione del progetto (non modificare) |

### `cacheUrl` e `runtimeUrl`

Se archivi le traduzioni nel cloud, `cacheUrl` è l&#39;URL di base della cache.
`runtimeUrl` è l&#39;URL di base del runtime e si applica solo alle traduzioni in fase di sviluppo.

### `stageTranslations`

`stageTranslations` è un flag usato dallo strumento `gt` per contrassegnare le traduzioni come da revisionare.
Ciò significa che devono essere approvate manualmente prima di poter essere distribuite in produzione tramite il comando [`gt translate`](/docs/cli/translate).

### `files`

Il campo `files` specifica il percorso delle traduzioni archiviate localmente (anziché nel cloud).
Più precisamente, il campo `output` specifica dove verranno scritte le traduzioni.

```json
{
  "files": {
    "gt": {
      "output": "public/_gt/[locale].json"
    }
  },
}
```

Per maggiori informazioni su come usare il campo `files`, consulta la [documentazione di configurazione](/docs/cli/reference/config) dello strumento CLI.


#### `parsingFlags`

L&#39;oggetto `files.gt.parsingFlags` controlla come il compilatore analizza i tuoi file di origine.

| Flag                     | Tipo      | Predefinito | Descrizione                                                                                                                                                                                        |
| ------------------------ | --------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `enableAutoJsxInjection` | `boolean` | `false`     | Avvolge automaticamente il testo JSX traducibile in componenti di traduzione durante la fase di build. Vedi [iniezione automatica di JSX](/docs/cli/features/auto-jsx-injection).                  |
| `autoderive`             | `boolean` | `false`     | Tratta automaticamente i valori interpolati nelle chiamate `t()`, `gt()` e `msg()` come chiamate a [`derive()`](/docs/react/api/strings/derive). Vedi [autoderive](/docs/cli/features/autoderive). |

```json title="gt.config.json"
{
  "files": {
    "gt": {
      "output": "public/_gt/[locale].json",
      "parsingFlags": {
        "enableAutoJsxInjection": true,
        "autoderive": true
      }
    }
  }
}
```

{/* 
  ### `_versionId`

  Aspetti da trattare:
  - interno
  - puoi specificare nomi di versione personalizzati */}

***

## Esempi

### Specificare le impostazioni regionali

```json title="gt.config.json"
{
  "defaultLocale": "en", // L'impostazione regionale primaria è l'inglese
  "locales": ["fr", "es"] // Le impostazioni regionali secondarie sono il francese e lo spagnolo
}
```

{/* ### Specificare un versionId personalizzato */}

***


## Note

* Il file `gt.config.json` viene utilizzato per specificare la configurazione del progetto.
* Viene letto sia dal componente [`<GTProvider>`](/docs/react/api/components/gtprovider) sia dal comando [`gt translate`](/docs/cli/translate).
* Deve essere collocato nella directory principale del progetto.

## Passaggi successivi