# gt-react: General Translation React SDK: Migración
URL: https://generaltranslation.com/es/docs/react/guides/migration.mdx
---
title: Migración
description: Aprende a migrar un proyecto a gt-react
---

{/* GENERADO AUTOMÁTICAMENTE: No edites esto directamente. En su lugar, edita el template en content/docs-templates/. */}


## Resumen

En esta guía se explican los pasos necesarios para migrar a `gt-react` un proyecto que ya usa una biblioteca de i18n.

También incluimos algunos consejos y sugerencias para que la migración sea lo más fluida posible.

## Requisitos previos

* Un proyecto que actualmente use otra biblioteca de i18n.
* Conocimientos básicos de la biblioteca `gt-react`.

## ¿Por qué migrar?

Hay muchas razones por las que quizá quieras migrar tu proyecto a `gt-react`.

Aquí tienes algunas:

* **Olvídate de los archivos JSON:** No vuelvas a gestionar traducciones en archivos JSON.
  Todo tu contenido está integrado en tu código, donde debe estar.
* **Traducciones automáticas:** Genera traducciones de alta calidad y con reconocimiento de contexto con nuestra herramienta de línea de comandos.
  No tendrás que volver a esperar traducciones.
* **Experimenta en desarrollo:** Prueba traducciones fácilmente durante el desarrollo con recarga en caliente.

## Configuración

<Steps>
  <Step>
    Instala `gt-react` y la herramienta de línea de comandos `gt`.

    <Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
      <Tab value="npm">
        ```bash
        npm i gt-react
        npm i gt
        ```
      </Tab>

      <Tab value="yarn">
        ```bash
        yarn add gt-react
        yarn add --dev gt
        ```
      </Tab>

      <Tab value="bun">
        ```bash
        bun add gt-react
        bun add --dev gt
        ```
      </Tab>

      <Tab value="pnpm">
        ```bash
        pnpm add gt-react
        pnpm add --save-dev gt
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step>
    Crea un archivo `gt.config.json` en la raíz de tu proyecto que incluya una propiedad `defaultLocale` y un array `locales`.

    ```json title="gt.config.json" copy
    {
      "defaultLocale": "en",
      "locales": ["en", "fr", "es"]
    }
    ```

    Agrega el componente `<GTProvider>` en la raíz de tu aplicación y propaga el objeto `config` como propiedades.

    ```tsx
    import { GTProvider } from 'gt-react'
    import config from './gt.config.json'

    <GTProvider {...config}>
      <App />
    </GTProvider>
    ```

    Para ver pasos más detallados, consulta la guía de [inicio rápido del proyecto](/docs/react).
  </Step>

  <Step>
    En este punto, tienes 3 opciones:

    1. Migrar por completo todo tu proyecto a `gt-react` y eliminar la biblioteca de i18n anterior.
    2. Migrar por completo tu proyecto, pero seguir usando diccionarios de la biblioteca de i18n anterior.
    3. Seguir usando la biblioteca de i18n anterior por ahora y migrar solo una parte de tu proyecto a `gt-react`.

    Para obtener más detalles sobre cada opción, consulta la sección [estrategias de migración](#strategies).
  </Step>
</Steps>

## Estrategias de migración [#strategies]

### Opción 1: Migra por completo tu proyecto

Esta opción es la más directa, pero también requerirá la mayor cantidad de cambios de código de una sola vez.

Después de configurar tu proyecto, tendrás que buscar todas las instancias de tu antigua biblioteca de i18n y reemplazarlas por `gt-react`.

Si tu aplicación usa hooks de React como `useTranslation`, busca todas las instancias de `useTranslation` en tu base de código y reemplázalas por `useGT`.

Después, tendrás que reemplazar todas las claves por los valores reales de las cadenas.

Por ejemplo, si tu código anterior se ve así:

```json title="dictionary.json"
{
  "hello": {
    "description": "Hello, world!"
  }
}
```

```tsx
export default function MyComponent() {
  const { t } = useTranslation()
  return <div>{t('hello.description')}</div>
}
```

Deberás reemplazarlo por:

```tsx
export default function MyComponent() {
  const { t } = useGT()
  return <div>{t('Hello, world!')}</div>
}
// O
export default function MyComponent() {
  return <T>Hello, world!</T>
}
```

Haz esto en todas las instancias de tu biblioteca i18n anterior.


### Opción 2: Migra completamente tu proyecto, pero sigue usando los diccionarios de la biblioteca de i18n anterior

Supongamos que quieres migrar tu proyecto a `gt-react`, pero quieres seguir usando los diccionarios de la biblioteca de i18n anterior
y usar solo las funciones inline de GT para el contenido nuevo.

En este caso, puedes hacer algo similar a la Opción 1:

Busca todas las instancias de tu biblioteca de i18n anterior, como los Hook `useTranslation`, y sustitúyelas por Hook `useTranslations`.

El Hook `useTranslations` se comporta de forma muy similar a los Hook `useTranslation`, y puedes usarlo de la misma manera.

<Tabs items={['Antes', 'Después']}>
  <Tab value="Antes">
    ```tsx
    import { useTranslation } from 'react-i18next'
    export default function MyComponent() {
      const { t } = useTranslation()
      return <div>{t('hello.description')}</div>
    }
    ```
  </Tab>

  <Tab value="Después">
    ```tsx
    import { useTranslations } from 'gt-react'
    export default function MyComponent() {
      const t = useTranslations()
      return <div>{t('hello.description')}</div>
    }
    ```
  </Tab>
</Tabs>

En cuanto a la configuración, tendrás que crear un archivo `dictionary.[js|ts|json]` en la raíz del proyecto o en el directorio `src`.
Copia el contenido de tu archivo de diccionario anterior a este nuevo archivo y luego pásalo al componente `GTProvider`.

```tsx
import { GTProvider } from 'gt-react'
import dictionary from './dictionary.json'
import config from './gt.config.json'

<GTProvider {...config} dictionary={dictionary}>
  <App />
</GTProvider>
```

Consulta la guía de [diccionarios](/docs/react/guides/dictionaries) para más detalles.


### Opción 3: Seguir usando la biblioteca de i18n anterior por ahora y migrar solo una parte de tu proyecto a `gt-react`

Esta opción es la más flexible y requiere la menor cantidad de cambios de código de una sola vez.

En este caso, puedes hacer algo similar a la Opción 2, pero migrar solo una parte de tu proyecto a `gt-react`.

Por ejemplo, puedes seguir usando la biblioteca de i18n anterior para algunos componentes y usar `gt-react` solo para otros y para el contenido nuevo.

<Callout type="warn">
  Esta opción no se recomienda, ya que tendrás que gestionar dos bibliotecas de i18n distintas en tu proyecto, lo que puede resultar complejo y provocar errores.
</Callout>

## Consejos para la migración

### 1. Usa el Hook `useGT` o el componente `<T>` siempre que sea posible

Siempre que sea posible, te recomendamos usar el Hook `useGT` o el componente `<T>`.

Esto hará que editar tu contenido en el futuro sea mucho más fácil y que tu base de código sea mucho más legible.

### 2. Usa el Hook `useTranslations` para el contenido existente

El Hook `useTranslations` es una muy buena forma de seguir usando tus diccionarios existentes.

Lo ofrecemos para facilitar la migración, pero no recomendamos usarlo para contenido nuevo.

### 3. Uso de IA

Si usas IA para ayudarte a migrar tu proyecto, tenemos disponibles `LLMs.txt` y `LLMs-full.txt` en:

* [LLMs.txt](/llms.txt)
* [LLMs-full.txt](/llms-full.txt)

Estos archivos contienen todo el contenido de esta documentación, por lo que tu herramienta de IA tendrá acceso a toda la información que necesita para ayudarte con la migración de tu proyecto.