@intlayer/docs 7.5.7 → 7.5.9

package/docs/es/cli/init.md

@@ -0,0 +1,84 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2025-12-30
+title: Inicializar Intlayer
+description: Aprende a inicializar Intlayer en tu proyecto.
+keywords:
+  - Inicializar
+  - CLI
+  - Intlayer
+  - AI
+slugs:
+  - doc
+  - concept
+  - cli
+  - init
+history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Agregar comando init
+---
+
+# Inicializar Intlayer
+
+```bash
+npx intlayer init
+```
+
+El comando `init` configura Intlayer automáticamente en tu proyecto ajustando los archivos y la configuración necesarios. Es la forma recomendada para comenzar con Intlayer.
+
+## Alias:
+
+- `npx intlayer init`
+
+## Argumentos:
+
+- `--project-root [projectRoot]` - Opcional. Especifica el directorio raíz del proyecto. Si no se proporciona, el comando buscará el directorio raíz del proyecto empezando desde el directorio de trabajo actual.
+
+## Qué hace:
+
+The `init` command performs the following setup tasks:
+
+1. **Valida la estructura del proyecto** - Asegura que estés en un directorio de proyecto válido con un archivo `package.json`
+2. **Actualiza `.gitignore`** - Agrega `.intlayer` a tu archivo `.gitignore` para excluir archivos generados del control de versiones
+3. **Configura TypeScript** - Actualiza todos los archivos `tsconfig.json` para incluir las definiciones de tipos de Intlayer (`.intlayer/**/*.ts`)
+4. **Crea archivo de configuración** - Genera un `intlayer.config.ts` (para proyectos TypeScript) o `intlayer.config.mjs` (para proyectos JavaScript) con la configuración por defecto
+5. **Actualiza la configuración de Vite** - Si se detecta un archivo de configuración de Vite, añade la importación del plugin `vite-intlayer`
+6. **Actualiza la configuración de Next.js** - Si se detecta un archivo de configuración de Next.js, agrega la importación del plugin `next-intlayer`
+
+## Ejemplos:
+
+### Inicialización básica:
+
+```bash
+npx intlayer init
+```
+
+Esto inicializará Intlayer en el directorio actual, detectando automáticamente la raíz del proyecto.
+
+### Inicializar con raíz de proyecto personalizada:
+
+```bash
+npx intlayer init --project-root ./my-project
+```
+
+Esto inicializará Intlayer en el directorio especificado.
+
+## Ejemplo de salida:
+
+```bash
+npx intlayer init
+Comprobando la configuración de Intlayer...
+✓ Agregado .intlayer a .gitignore
+✓ Actualizado tsconfig.json para incluir los tipos de Intlayer
+Creado intlayer.config.ts
+✓ Inyectada la importación en vite.config.ts
+✓ Inicialización de Intlayer completada.
+```
+
+## Notas:
+
+- El comando es idempotente - puedes ejecutarlo varias veces de forma segura. Omitirá los pasos que ya estén configurados.
+- Si ya existe un archivo de configuración, no será sobrescrito.
+- Se omiten los archivos de configuración de TypeScript que no tienen un `include` array (p. ej., configuraciones solution-style con referencias).
+- El comando finalizará con un error si no se encuentra un `package.json` en la raíz del proyecto.

package/docs/es/cli/sdk.md

@@ -31,6 +31,10 @@ yarn add @intlayer/cli --save-dev
 pnpm add @intlayer/cli --save-dev
 ```
 
+```bash packageManager="bun"
+bun add @intlayer/cli --dev
+```
+
 Ejemplo de uso:
 
 ```ts

package/docs/es/intlayer_visual_editor.md

@@ -80,6 +80,10 @@ yarn add intlayer-editor --save-dev
 pnpm add intlayer-editor --save-dev
 ```
 
+```bash packageManager="bun"
+bun add intlayer-editor --dev
+```
+
 ## Configuración
 
 En tu archivo de configuración de Intlayer, puedes personalizar los ajustes del editor:

package/docs/es/intlayer_with_angular.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2025-06-29
-title: Cómo traducir tu Angular – guía i18n 2025
+updatedAt: 2025-12-30
+title: Cómo traducir tu Angular – guía i18n 2026
 description: Descubre cómo hacer que tu sitio web con Angular sea multilingüe. Sigue la documentación para internacionalizarlo (i18n) y traducirlo.
 keywords:
   - Internacionalización
@@ -15,6 +15,9 @@ slugs:
   - angular
 # applicationTemplate: https://github.com/aymericzip/intlayer-angular-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Agregar comando init
   - version: 5.5.10
     date: 2025-06-29
     changes: Historial inicial
@@ -47,14 +50,22 @@ Instala los paquetes necesarios usando npm:
 
 ```bash packageManager="npm"
 npm install intlayer angular-intlayer @intlayer/webpack
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer angular-intlayer @intlayer/webpack
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer angular-intlayer @intlayer/webpack
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer angular-intlayer @intlayer/webpack
+bunx intlayer init
 ```
 
 - **intlayer**

package/docs/es/intlayer_with_astro.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2025-10-03
-title: Cómo traducir tu Astro – guía i18n 2025
+updatedAt: 2025-12-30
+title: Cómo traducir tu Astro – guía i18n 2026
 description: Aprende cómo agregar internacionalización (i18n) a tu sitio web Astro usando Intlayer. Sigue esta guía para hacer tu sitio multilingüe.
 keywords:
   - Internacionalización
@@ -17,6 +17,9 @@ slugs:
   - astro
 applicationTemplate: https://github.com/aymericzip/intlayer-astro-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Agregar comando init
   - version: 6.2.0
     date: 2025-10-03
     changes: Actualización para integración con Astro, configuración, uso

package/docs/es/intlayer_with_create_react_app.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-06-29
-title: Cómo traducir tu Create React App – guía i18n 2025
+updatedAt: 2025-12-30
+title: Cómo traducir tu Create React App – guía i18n 2026
 description: Descubre cómo hacer que tu sitio web de Create React App (CRA) sea multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización
@@ -17,6 +17,9 @@ slugs:
   - create-react-app
 applicationTemplate: https://github.com/aymericzip/intlayer-react-cra-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Agregar comando init
   - version: 5.5.10
     date: 2025-06-29
     changes: Historial inicial
@@ -45,14 +48,22 @@ Instala los paquetes necesarios usando npm:
 
 ```bash packageManager="npm"
 npm install intlayer react-intlayer react-scripts-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer react-intlayer react-scripts-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer react-intlayer react-scripts-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer react-intlayer react-scripts-intlayer
+bunx intlayer init
 ```
 
 - **intlayer**

package/docs/es/intlayer_with_express.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-06-29
-title: Cómo traducir tu Express backend – guía i18n 2025
+updatedAt: 2025-12-30
+title: Cómo traducir tu Express backend – guía i18n 2026
 description: Descubre cómo hacer que tu backend de Express sea multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización
@@ -15,6 +15,9 @@ slugs:
   - environment
   - express
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Agregar comando init
   - version: 5.5.10
     date: 2025-06-29
     changes: Historial inicial
@@ -48,14 +51,22 @@ Para comenzar a usar `express-intlayer`, instala el paquete usando npm:
 
 ```bash packageManager="npm"
 npm install intlayer express-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer express-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer express-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer express-intlayer
+bunx intlayer init
 ```
 
 ### Configuración

package/docs/es/intlayer_with_lynx+react.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-03-09
-updatedAt: 2025-06-29
-title: Cómo traducir tu Lynx and React mobile app – guía i18n 2025
+updatedAt: 2025-12-30
+title: Cómo traducir tu Lynx and React mobile app – guía i18n 2026
 description: Descubre cómo hacer que tu aplicación móvil Lynx y React sea multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirla.
 keywords:
   - Internacionalización
@@ -17,6 +17,9 @@ slugs:
   - lynx-and-react
 applicationTemplate: https://github.com/aymericzip/intlayer-lynx-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Agregar comando init
   - version: 5.5.10
     date: 2025-06-29
     changes: Historial inicial
@@ -45,14 +48,22 @@ Desde tu proyecto Lynx, instala los siguientes paquetes:
 
 ```bash packageManager="npm"
 npm install intlayer react-intlayer lynx-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer react-intlayer lynx-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer react-intlayer lynx-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer react-intlayer lynx-intlayer
+bunx intlayer init
 ```
 
 ### Paquetes

package/docs/es/intlayer_with_nestjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2025-09-09
-title: Cómo traducir tu Nest backend – guía i18n 2025
+updatedAt: 2025-12-30
+title: Cómo traducir tu Nest backend – guía i18n 2026
 description: Descubre cómo hacer que tu backend NestJS sea multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización
@@ -17,6 +17,9 @@ slugs:
 applicationTemplate: https://github.com/AydinTheFirst/nestjs-intlayer
 author: AydinTheFirst
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Agregar comando init
   - version: 5.8.0
     date: 2025-09-09
     changes: Documento inicial
@@ -59,14 +62,22 @@ Para comenzar a usar `express-intlayer`, instale el paquete usando npm:
 
 ```bash packageManager="npm"
 npm install intlayer express-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer express-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer express-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer express-intlayer
+bunx intlayer init
 ```
 
 ### Configurar tsconfig.json

package/docs/es/intlayer_with_next-i18next.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Cómo traducir tu Next.js 15 usando next-i18next – guía i18n 2025
+title: Cómo traducir tu Next.js 15 usando next-i18next – guía i18n 2026
 description: Una guía práctica y lista para producción para internacionalizar una app Next.js 15 App Router con i18next/next-i18next y mejorarla con Intlayer.
 keywords:
   - Internacionalización
@@ -57,6 +57,10 @@ pnpm add next-i18next i18next react-i18next i18next-resources-to-backend
 yarn add next-i18next i18next react-i18next i18next-resources-to-backend
 ```
 
+```bash packageManager="bun"
+bun add next-i18next i18next react-i18next i18next-resources-to-backend
+```
+
 Comienza con una estructura clara. Mantén los mensajes divididos por locale y namespace.
 
 ```bash
@@ -554,14 +558,22 @@ Instala las dependencias de intlayer:
 
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin --dev
+bunx intlayer init
 ```
 
 ```ts fileName="intlayer.config.ts"

package/docs/es/intlayer_with_next-intl.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Cómo traducir tu Next.js 15 usando next-intl – guía i18n 2025
+title: Cómo traducir tu Next.js 15 usando next-intl – guía i18n 2026
 description: Descubre cómo hacer tu sitio web Next.js 15 App Router multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización
@@ -52,6 +52,10 @@ pnpm add next-intl
 yarn add next-intl
 ```
 
+```bash packageManager="bun"
+bun add next-intl
+```
+
 ```bash
 .
 ├── locales
@@ -402,6 +406,11 @@ yarn add intlayer @intlayer/sync-json-plugin --dev
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
 ```
 
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin --dev
+bunx intlayer init
+```
+
 Crea el archivo de configuración de intlayer:
 
 ```tsx fileName="intlayer.config.ts"

package/docs/es/intlayer_with_nextjs_14.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
-updatedAt: 2025-06-29
-title: Cómo traducir tu Next.js 14 and App Router – guía i18n 2025
+updatedAt: 2025-12-30
+title: Cómo traducir tu Next.js 14 and App Router – guía i18n 2026
 description: Descubre cómo hacer tu sitio web Next.js 14 App Router multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización
@@ -17,6 +17,9 @@ slugs:
   - 14
 applicationTemplate: https://github.com/aymericzip/intlayer-next-14-template
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Agregar comando init
   - version: 5.5.10
     date: 2025-06-29
     changes: Historial inicial
@@ -50,14 +53,22 @@ Instala los paquetes necesarios usando npm:
 
 ```bash packageManager="npm"
 npm install intlayer next-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer next-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer next-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer next-intlayer
+bunx intlayer init
 ```
 
 - **intlayer**
@@ -1442,14 +1453,22 @@ Para habilitar esta optimización, instala el paquete `@intlayer/swc`. Una vez i
 
 ```bash packageManager="npm"
 npm install @intlayer/swc --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add @intlayer/swc --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add @intlayer/swc --save-dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add @intlayer/swc --dev
+bunx intlayer init
 ```
 
 > Nota: Esta optimización solo está disponible para Next.js 13 y versiones superiores.

package/docs/es/intlayer_with_nextjs_15.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
-updatedAt: 2025-06-29
-title: Cómo traducir tu Next.js 15 – guía i18n 2025
+updatedAt: 2025-12-30
+title: Cómo traducir tu Next.js 15 – guía i18n 2026
 description: Descubre cómo hacer tu sitio web Next.js 15 multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización
@@ -18,6 +18,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-next-15-template
 youtubeVideo: https://www.youtube.com/watch?v=e_PPG7PTqGU
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Agregar comando init
   - version: 5.5.10
     date: 2025-06-29
     changes: Historial inicial
@@ -53,14 +56,22 @@ Instala los paquetes necesarios usando npm:
 
 ```bash packageManager="npm"
 npm install intlayer next-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer next-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer next-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer next-intlayer
+bunx intlayer init
 ```
 
 - **intlayer**
@@ -1474,14 +1485,22 @@ Para habilitar esta optimización, instale el paquete `@intlayer/swc`. Una vez i
 
 ```bash packageManager="npm"
 npm install @intlayer/swc --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add @intlayer/swc --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add @intlayer/swc --save-dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add @intlayer/swc --dev
+bunx intlayer init
 ```
 
 > Nota: Esta optimización solo está disponible para Next.js 13 y versiones superiores.

package/docs/es/intlayer_with_nextjs_16.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
-updatedAt: 2025-10-26
-title: Cómo traducir tu aplicación Next.js 16 – Guía i18n 2025
+updatedAt: 2025-12-30
+title: Cómo traducir tu aplicación Next.js 16 – Guía i18n 2026
 description: Descubre cómo hacer que tu sitio web Next.js 16 sea multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización
@@ -17,6 +17,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-next-16-template
 youtubeVideo: https://www.youtube.com/watch?v=e_PPG7PTqGU
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Agregar comando init
   - version: 7.0.0
     date: 2025-06-29
     changes: Historial inicial
@@ -73,14 +76,22 @@ Instala los paquetes necesarios usando npm:
 
 ```bash packageManager="npm"
 npm install intlayer next-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer next-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer next-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer next-intlayer
+bunx intlayer init
 ```
 
 - **intlayer**
@@ -1639,14 +1650,22 @@ Para habilitar esta optimización, instala el paquete `@intlayer/swc`. Una vez i
 
 ```bash packageManager="npm"
 npm install @intlayer/swc --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add @intlayer/swc --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add @intlayer/swc --save-dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add @intlayer/swc --dev
+bunx intlayer init
 ```
 
 > Nota: Esta optimización solo está disponible para Next.js 13 y versiones superiores.

package/docs/es/intlayer_with_nextjs_page_router.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-07
-updatedAt: 2025-06-29
-title: Cómo traducir tu Next.js and Page Router – guía i18n 2025
+updatedAt: 2025-12-30
+title: Cómo traducir tu Next.js and Page Router – guía i18n 2026
 description: Descubre cómo hacer que tu sitio web Next.js usando Page Router sea multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización
@@ -17,6 +17,9 @@ slugs:
   - nextjs
   - next-with-page-router
 history:
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: Agregar comando init
   - version: 5.5.10
     date: 2025-06-29
     changes: Historial inicial
@@ -47,14 +50,22 @@ Instala los paquetes necesarios usando tu gestor de paquetes preferido:
 
 ```bash packageManager="npm"
 npm install intlayer next-intlayer
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer next-intlayer
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer next-intlayer
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add intlayer next-intlayer
+bunx intlayer init
 ```
 
 - **intlayer**
@@ -1410,14 +1421,22 @@ Para habilitar esta optimización, instala el paquete `@intlayer/swc`. Una vez i
 
 ```bash packageManager="npm"
 npm install @intlayer/swc --save-dev
+npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add @intlayer/swc --save-dev
+pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add @intlayer/swc --save-dev
+yarn intlayer init
+```
+
+```bash packageManager="bun"
+bun add @intlayer/swc --dev
+bunx intlayer init
 ```
 
 > Nota: Esta optimización solo está disponible para Next.js 13 y versiones superiores.