# react-native: gt.config.json
URL: https://generaltranslation.com/es/docs/react-native/api/config/gt-config-json.mdx
---
title: gt.config.json
description: El archivo gt.config.json
---

{/* GENERADO AUTOMÁTICAMENTE: No edites esto directamente. Edita la plantilla en content/docs-templates/. */}


## Resumen

El archivo `gt.config.json` almacena la configuración de tu proyecto.
Contiene información importante, como el `projectId` de tu proyecto, los locales compatibles y más.
También contiene información interna importante, como el `versionId` de tu proyecto.

Este archivo lo leen (1) tu componente [`<GTProvider>`](/docs/react-native/api/components/gtprovider) y (2) el comando [`gt translate`](/docs/cli/translate).
Por eso, te recomendamos guardar la configuración en tu archivo `gt.config.json` en lugar de pasarla como una prop a tu componente [`<GTProvider>`](/docs/react-native/api/components/gtprovider).

En general, cualquier elemento que empiece por un guion bajo (p. ej., `_versionId`) es una propiedad interna y no debe modificarse.
Todo lo demás puede modificarse.

***

## Campos

| Campo               | Tipo       | Descripción                                                                       |
| ------------------- | ---------- | --------------------------------------------------------------------------------- |
| `projectId`         | `string`   | Identificador único de tu proyecto en el sistema GT                               |
| `locales`           | `string[]` | Lista de códigos de locales compatibles para tu proyecto                          |
| `defaultLocale`     | `string`   | Código de locale principal que se usa como respaldo cuando faltan traducciones    |
| `cacheUrl`          | `string`   | URL del endpoint de caché para los datos de traducción                            |
| `runtimeUrl`        | `string`   | URL del endpoint para los servicios de traducción en runtime                      |
| `stageTranslations` | `boolean`  | Configuración de las funciones de traducción para staging/vista previa            |
| `files`             | `object`   | Ruta a los archivos de traducción locales para desarrollo y pruebas               |
| `_versionId`        | `string`   | Propiedad interna que se usa para rastrear la versión del proyecto (no la modifiques)          |

### `cacheUrl` y `runtimeUrl`

Si almacenas tus traducciones en la nube, `cacheUrl` es la URL base de la caché.
`runtimeUrl` es la URL base del runtime y solo se aplica a las traducciones en desarrollo.

### `stageTranslations`

`stageTranslations` es una marca que utiliza la herramienta `gt` para indicar que tus traducciones requieren revisión.
Esto significa que deben aprobarse manualmente antes de poder desplegarse en producción mediante el comando [`gt translate`](/docs/cli/translate).

### `files`

El campo `files` especifica una ruta a las traducciones almacenadas localmente (en lugar de almacenarlas en la nube).
En concreto, el campo `output` especifica dónde se escribirán las traducciones.

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

Consulta la [documentación de configuración](/docs/cli/reference/config) de la herramienta de CLI para obtener más información sobre cómo usar el campo `files`.


#### `parsingFlags`

El objeto `files.gt.parsingFlags` controla cómo el compilador analiza tus archivos de origen.

| Opción                   | Tipo      | Predeterminado | Descripción                                                                                                                                                                                                         |
| ------------------------ | --------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `enableAutoJsxInjection` | `boolean` | `false`        | Envuelve automáticamente el texto JSX traducible con componentes de traducción en tiempo de construcción. Consulta [inyección automática de JSX](/docs/cli/features/auto-jsx-injection).                            |
| `autoderive`             | `boolean` | `false`        | Trata automáticamente los valores interpolados en las llamadas a `t()`, `gt()` y `msg()` como llamadas a [`derive()`](/docs/react-native/api/strings/derive). Consulta [autoderive](/docs/cli/features/autoderive). |

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

{/* 
  ### `_versionId`

  Puntos clave:
  - interno
  - puedes especificar tus propios nombres de versión */}

***

## Ejemplos

### Cómo especificar tus locales

```json title="gt.config.json"
{
  "defaultLocale": "en", // La locale principal es inglés
  "locales": ["fr", "es"] // Los locales secundarios son francés y español
}
```

{/* ### Especificar tu propio versionId */}

***


## Notas

* El archivo `gt.config.json` se utiliza para especificar la configuración de tu proyecto.
* Lo leen tanto el componente [`<GTProvider>`](/docs/react-native/api/components/gtprovider) como el comando [`gt translate`](/docs/cli/translate).
* Debe colocarse en la raíz de tu proyecto.

## Próximos pasos