# 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. En su lugar, 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, tus 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/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).

Generalmente, cualquier elemento que empiece 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[]` | Array de códigos de configuración regional compatibles para tu proyecto                           |
| `defaultLocale`     | `string`   | Código principal de configuración regional que se usa como alternativa 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 tiempo de ejecución                          |
| `stageTranslations` | `boolean`  | Configuración de las funcionalidades de traducción para entornos de preparación o vista previa    |
| `files`             | `object`   | Ruta a los archivos de traducción locales para desarrollo y pruebas                               |
| `_versionId`        | `string`   | Propiedad interna usada para rastrear la versión del proyecto (no modificar)                      |

### `cacheUrl` y `runtimeUrl`

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

### `stageTranslations`

`stageTranslations` es una opción de la herramienta `gt` que marca 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 la ruta de las traducciones almacenadas de forma local (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 CLI para obtener más información sobre cómo usar el campo `files`.

{/* 
  ### `_versionId`

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

***


## Ejemplos

### Especifica 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
}
```

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

***


## Notas

* El archivo `gt.config.json` se usa 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