# gt-next: General Translation Next.js SDK: gt.config.json
URL: https://generaltranslation.com/es/docs/next/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` se encarga de almacenar la configuración de tu proyecto.
Contiene información importante, como el `projectId` de tu proyecto, los locales admitidos y más.
También incluye información interna importante, como el `versionId` de tu proyecto.

Este archivo lo leen (1) tu componente [`<GTProvider>`](/docs/next/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/next/api/components/gtprovider).

En general, todo lo que empieza con un guion bajo (por ejemplo, `_versionId`) es una propiedad interna y no debe modificarse.
Todo lo demás se puede modificar.

***

## Campos

| Campo               | Tipo       | Descripción                                                                                    |
| ------------------- | ---------- | ---------------------------------------------------------------------------------------------- |
| `projectId`         | `string`   | Identificador único de tu proyecto en el sistema GT                                            |
| `locales`           | `string[]` | Lista de códigos de configuración regional compatibles con tu proyecto                         |
| `defaultLocale`     | `string`   | Código de configuración regional principal que se usa como respaldo cuando faltan traducciones |
| `cacheUrl`          | `string`   | URL del endpoint para almacenar en caché 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 opción que usa la herramienta `gt` para marcar tus traducciones como pendientes de 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 traducciones almacenadas localmente (en lugar de guardarlas 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 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 en componentes de traducción en tiempo de construcción. Consulta [auto JSX injection](/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/next/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 configuración regional principal es inglés
  "locales": ["fr", "es"] // Las configuraciones regionales secundarias son francés y español
}
```

{/* ### Definir 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/next/api/components/gtprovider) como el comando [`gt translate`](/docs/cli/translate).
* Debe colocarse en la raíz de tu proyecto.

## Próximos pasos