# gt-next: General Translation Next.js SDK: Migración
URL: https://generaltranslation.com/es/docs/next/guides/migration.mdx
---
title: Migración
description: Aprende a migrar un proyecto a gt-next
---
## Descripción general
En esta guía se explican los pasos necesarios para migrar un proyecto que ya usa una biblioteca de i18n a gt-next.
También te daremos algunos consejos y recomendaciones para que la migración sea lo más sencilla posible.
## Requisitos previos
* Un proyecto que actualmente use otra biblioteca de i18n.
* Conocimientos básicos de la biblioteca `gt-next`.
## ¿Por qué migrar?
Hay muchas razones por las que quizá quieras migrar tu proyecto a gt-next.
Estas son solo algunas:
* **Se acabaron 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, adaptadas al contexto, con nuestra herramienta CLI.
No volverás a tener que esperar traducciones.
* **Experimenta en desarrollo:** Prueba traducciones fácilmente durante el desarrollo con recarga en caliente.
## Configuración
Instala `gt-next` y la herramienta de línea de comandos `gt`.
```bash
npm i gt-next gt
```
```bash
yarn add gt-next
yarn add --dev gt
```
```bash
bun add gt-next
bun add --dev gt
```
```bash
pnpm add gt-next
pnpm add --save-dev gt
```
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"]
}
```
Luego, agrega el componente `` al layout raíz de tu aplicación.
```tsx title="app/layout.tsx" copy
import { GTProvider } from 'gt-next'
export default function RootLayout({ children }) {
return (
{children}
)
}
```
A continuación, agrega `withGTConfig` a tu archivo `next.config.js`.
```js title="next.config.ts" copy
import { withGTConfig } from 'gt-next/config'
const nextConfig = {
// Tus opciones de next.config.ts
}
export default withGTConfig(nextConfig, {
// Tu configuración de GT
})
```
Para ver los pasos con más detalle, consulta la [guía de inicio rápido](/docs/next).
En este punto, tienes 3 opciones:
1. Migrar por completo todo tu proyecto a `gt-next` y eliminar la biblioteca de i18n anterior.
2. Migrar por completo tu proyecto, pero seguir usando los 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-next`.
Para obtener más información sobre cada opción, consulta la sección [estrategias de migración](#strategies).
## Estrategias de migración [#strategies]
### Opción 1: Migra completamente 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 biblioteca de i18n anterior y reemplazarlas por `gt-next`.
Si tu aplicación usa hooks de React como `useTranslations`, busca todas las instancias de `useTranslations` en tu base de código y reemplázalas por `useGT`.
Después, tendrás que reemplazar todas las claves de cadena por sus valores de cadena reales.
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 {t('hello.description')}
}
```
Deberás reemplazarlo por:
```tsx
export default function MyComponent() {
const gt = useGT()
return {gt('Hello, world!')}
}
// OR
export default function MyComponent() {
return Hello, world!
}
```
Haz esto en todas las instancias de tu antigua biblioteca de i18n.
### Opción 2: Migra por completo tu proyecto, pero sigue usando diccionarios de la biblioteca de i18n anterior
Supongamos que quieres migrar tu proyecto a `gt-next`, pero quieres seguir usando los diccionarios de la biblioteca de i18n anterior
y usar las funciones inline de GT solo para el contenido nuevo.
En este caso, puedes hacer algo similar a la opción 1:
Busca todas las apariciones de tu biblioteca de i18n anterior, como los hooks `useTranslations`, y reemplázalas por los hooks `useTranslations` de `gt-next`.
El hook `useTranslations` se comporta de forma muy similar a los hooks `useTranslations` de otras bibliotecas de i18n, y puedes usarlo de la misma manera.
```tsx
import { useTranslation } from 'react-i18next'
export default function MyComponent() {
const { t } = useTranslation()
return {t('hello.description')}
}
```
```tsx
import { useTranslations } from 'gt-next'
export default function MyComponent() {
const t = useTranslations()
return {t('hello.description')}
}
```
En cuanto a la configuración, tendrás que crear un archivo `dictionary.[js|ts|json]` en la raíz de tu proyecto o en el directorio `src`.
Copia el contenido de tu archivo de diccionario anterior en este nuevo archivo.
La función de inicialización `withGTConfig` en `next.config.js` detectará automáticamente el archivo de diccionario en la raíz de tu proyecto o en el directorio `src`.
Consulta la guía de [diccionarios](/docs/next/guides/dictionaries) para obtener más información.
### Opción 3: Sigue usando la biblioteca de i18n anterior por ahora y migra solo una parte de tu proyecto a `gt-next`
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 migrando solo una parte de tu proyecto a `gt-next`.
Por ejemplo, puedes seguir usando la biblioteca de i18n anterior para algunos componentes y usar `gt-next` solo para otros y para el contenido nuevo.
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.
## Consejos para la migración
### 1. Usa el hook `useGT` o el componente `` siempre que sea posible
Siempre que sea posible, te recomendamos usar el hook `useGT` o el componente ``.
Esto hará que editar tu contenido en el futuro sea mucho más fácil y que tu 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, tienes `LLMs.txt` y `LLMs-full.txt` disponibles en:
* [LLMs.txt](/llms.txt)
* [LLMs-full.txt](/llms-full.txt)