@intlayer/docs 9.0.0-canary.8 → 9.0.0

package/docs/es/migration_from_vue-i18n_to_intlayer.md

@@ -100,19 +100,23 @@ Los siguientes pasos son el mínimo requerido para que tu aplicación `vue-i18n`
 Instala los paquetes principales de Intlayer y el adaptador de compatibilidad:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > la bandera `--interactive` es opcional. Usa `intlayer-cli init` si eres un agente de IA.

package/docs/es/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-07-08
 title: Nuevo Intlayer v9 - ¿Qué hay de nuevo?
 description: Descubre las novedades de Intlayer v9. Presentamos paquetes de compatibilidad directos para librerías i18n populares y soporte para Colecciones y Variantes.
 keywords:
@@ -9,9 +9,13 @@ keywords:
   - Migration
   - Collections
   - Variants
+  - CMS SDK
+  - Self-Hosting
+  - Docker
   - i18next
   - next-intl
   - vue-i18n
+youtubeVideo: https://www.youtube.com/watch?v=ia6JmVf-kkU
 slugs:
   - doc
   - releases
@@ -23,6 +27,14 @@ author: aymericzip
 
 ¡Bienvenido a Intlayer v9! Esta importante versión marca un gran hito al simplificar la ruta de migración a Intlayer con **Paquetes Adaptadores de Compatibilidad** para las principales librerías i18n (`react-i18next`, `next-intl`, `vue-i18n`, etc.) y añade soporte para estructuras de contenido enriquecido: **Colecciones** y **Variantes**.
 
+<iframe
+  src="https://www.youtube.com/embed/ia6JmVf-kkU"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo Video - New Intlayer v9 - What's new?"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
 ## Tabla de contenidos
 
 <TOC levels={[2]} maxDepth={1} />
@@ -109,36 +121,40 @@ Intlayer v9 se expande más allá de los objetos estáticos clave-valor, permiti
 
 Define una lista de elementos ordenados gestionada por CMS (por ejemplo, FAQs, productos o listas de blogs):
 
-```ts fileName="faq.content.ts"
+```ts fileName="faq.1.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "faq",
-  content: [
-    {
-      question: t({
-        es: "¿Qué es Intlayer?",
-        en: "What is Intlayer?",
-        fr: "Qu'est-ce qu'Intlayer ?",
-      }),
-      answer: t({
-        es: "Un toolkit i18n.",
-        en: "An i18n toolkit.",
-        fr: "Une boîte à outils i18n.",
-      }),
-    },
-  ],
+  item: 1,
+  content: {
+    question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
+    answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
+  },
+} satisfies Dictionary;
+```
+
+```ts fileName="faq.2.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 2,
+  content: {
+    question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
+    answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
+  },
 } satisfies Dictionary;
 ```
 
 #### Uso:
 
 ```ts
-// Fetch all items
+// Fetch all items as an array
 const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
 
-// Fetch single item by index
-const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+// Fetch a single item by index
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
 ```
 
 ### 2. Variantes
@@ -188,28 +204,52 @@ export default {
 ```ts
 // Fetches only the requested item dynamically (requires Suspense)
 const product = useIntlayer("product-copy", {
-  id: "prod_123",
-  category: "books",
+  variant: { id: "prod_123", category: "books" },
 });
 ```
 
 ---
 
-## Carga Dinámica y Optimizaciones del Tamaño del Bundle
-
-Para mantener los bundles extremadamente pequeños, Intlayer v9 soporta la carga perezosa dinámica.
-
-En tu configuración, establece `importMode` a `'dynamic'` o `'fetch'`::
-
-```ts fileName="intlayer.config.ts"
-export default {
-  dictionary: {
-    importMode: "dynamic", // "static" | "dynamic" | "fetch"
-  },
+## `@intlayer/analytics`: seguimiento de exposición de contenido y pruebas A/B
+
+Un nuevo paquete opcional, [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md), te indica qué contenido ven realmente tus visitantes — y cierra el círculo con **Collections & Variants**, permitiéndote hacer pruebas A/B de contenido y medir conversiones por variante.
+
+- **Seguimiento a nivel de provider**: `IntlayerProvider` (React / Next.js / React Native) registra automáticamente eventos `page_view` al cargar, al cambiar de ruta y al cambiar de idioma.
+- **Seguimiento a nivel de nodo**: cada resolución de `useIntlayer` reporta un evento `content_exposure` — qué clave de diccionario, ruta de clave, idioma y, cuando aplica, qué **variante** A/B se mostró. Las exposiciones repetidas del mismo nodo dentro de una ventana de envío se combinan en un solo evento.
+- **Asignación determinista de A/B**: `getVariant(experimentKey, variants)` asigna una variante a cada sesión **sin ida y vuelta al servidor**, por lo que no hay parpadeo antes del primer renderizado.
+- **`useConversion()`**: atribuye un objetivo (registro, clic, compra…) a la variante a la que estuvo expuesta la sesión.
+- **Coste cero si no está instalado**: mismo patrón tree-shakeable que `@intlayer/editor` — `import()` dinámico envuelto en `try/catch`, más una variable de entorno en tiempo de compilación (`INTLAYER_ANALYTICS_ENABLED`) que elimina por completo la integración del bundle para las apps que no la activan.
+- **Sin nuevo esquema de configuración**: reutiliza `editor.backendURL` (endpoint de envío / auto-alojamiento) y `editor.clientId` (clave del proyecto, que también actúa como interruptor de activación).
+- **Respetuoso con la privacidad**: hash anónimo de sesión (SHA-256, sin almacenar ids en bruto), sin almacenamiento de IP, geolocalización aproximada solo por país, solicitudes enviadas por lotes aproximadamente cada 20 segundos.
+- **Panel**: una nueva página **Analytics** (visible en la barra lateral una vez seleccionado un proyecto) muestra usuarios activos, usuarios de hoy, usuarios de los últimos 7/30/90 días, un gráfico de evolución de visitantes y desgloses por idioma y ubicación.
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      Get started
+    </button>
+  );
 };
 ```
 
-En tiempo de compilación, `@intlayer/swc` y `@intlayer/babel` escanean tus archivos y reemplazan las llamadas a `useIntlayer` / `getIntlayer` con wrappers tree-shakeable (`useDictionary` / `useDictionaryDynamic`). Solo se carga el contenido requerido para el elemento de colección, variante o locale seleccionado, evitando que tu bundle de producción contenga traducciones no utilizadas.
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+Disponible hoy para React, Next.js y React Native (a través de `react-intlayer`); otras integraciones de frameworks (Vue, Svelte, Angular, …) están planificadas, siguiendo el mismo patrón de despliegue que `@intlayer/editor`. Consulta la [documentación de Analytics](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) para la guía completa.
 
 ---
 
@@ -292,13 +332,68 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## SDK de CMS: usa Intlayer como una base de datos de contenido headless
+
+Intlayer v9 incluye un SDK limpio y con autenticación automática en `@intlayer/api` para interactuar con el CMS de forma programática: obtener proyectos, obtener diccionarios y enviarlos o actualizarlos desde tu propio servidor, scripts o CI. La autenticación (OAuth2 `client_credentials`) se gestiona y renueva por ti.
+
+El SDK se divide en **dos importaciones separadas** para que tu bundle incluya solo los dominios que realmente usas:
+
+1. `createIntlayerCMS` — un **autenticador** ligero que contiene las credenciales y el token gestionado (sin ningún cliente de dominio incluido).
+2. `dictionaryEndpoint`, `projectEndpoint`, … — **enlazadores de endpoint** por dominio, cada uno importado desde su propia subruta.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// La configuración es opcional: las credenciales recurren a INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET resueltos por `@intlayer/config/built`.
+const cms = createIntlayerCMS();
+
+// Lectura
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// Escritura — usa el CMS como una base de datos
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> Seguridad: las credenciales del CMS otorgan acceso de escritura a tu contenido. Crea el autenticador siempre **en el lado del servidor** — nunca envíes `clientId` / `clientSecret` al navegador.
+
+---
+
+## Auto-alojamiento
+
+Intlayer v9 incluye soporte de primera clase para ejecutar tu propia instancia de Intlayer con un solo comando — sin necesidad de cuenta en Intlayer Cloud.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+El instalador descarga un `docker-compose.yml` y un `.env`, genera automáticamente los secretos necesarios y ejecuta `docker compose up -d`. Todo — el panel de control, la API, la base de datos, el almacenamiento de objetos y el correo electrónico transaccional — se ejecuta localmente en contenedores.
+
+### Servicios incluidos
+
+| Servicio                                | Propósito                                                                        |
+| --------------------------------------- | -------------------------------------------------------------------------------- |
+| **app** (TanStack Start)                | Interfaz del panel de control en el puerto `3000`                                |
+| **backend** (Fastify/Bun)               | API REST en el puerto `3100`                                                     |
+| **MongoDB 7** (single-node replica set) | Base de datos principal                                                          |
+| **Redis 7**                             | Colas de trabajos y caché                                                        |
+| **MinIO**                               | Almacenamiento de objetos compatible con S3 (avatares, capturas de pantalla)     |
+| **Mailpit**                             | Sumidero SMTP local + interfaz web para correo transaccional en el puerto `8025` |
+
+Chromium (usado para la generación de capturas de pantalla con Puppeteer) está incluido dentro de la imagen del backend — no se necesita ningún contenedor adicional.
+
+---
+
 ## Notas de migración desde v8
 
 Si estás actualizando desde v8, ten en cuenta que la v9 no incluye cambios disruptivos. Pero aquí están los cambios clave:
 
 - **Compilador deshabilitado por defecto**: `compiler.enabled` ahora tiene el valor predeterminado `false`. Si dependes de la extracción de tus archivos `.content.ts` en tiempo de compilación, establece `compiler.enabled: true` en tu `intlayer.config.ts`.
+- **Plugin de Vite**: El compilador y el proxy de enrutamiento de locales ahora están integrados en `intlayer()`. Si previamente registraste `intlayerCompiler()` o `intlayerProxy()` manualmente, puedes eliminarlos — se deduplicanautomáticamente, por lo que mantenerlos es inofensivo. Usa `routing.enableProxy: false` para desactivar el proxy.
 - **Locales y Dialectos**: Si utilizas dependencias i18n externas, añade sus respectivos plugins adaptadores de compatibilidad en tu configuración o setup del bundler para reescribir automáticamente los imports.
 - **Selectores Personalizados**: Al llamar a `useIntlayer`, el segundo parámetro ahora está reservado para un objeto de opciones que contiene `{ locale, item, variant }`. Si anteriormente pasabas una cadena de locale directamente, aún puedes hacerlo, pero se recomienda usar el objeto de opciones para selecciones avanzadas.
+- **React Native**: `react-native-intlayer` ahora reexporta toda la API de `react-intlayer`. En una aplicación React Native, importa todo desde `react-native-intlayer` y elimina la dependencia directa a `react-intlayer`. Los imports existentes de `react-intlayer` siguen funcionando.
 
 ---
 
@@ -306,4 +401,7 @@ Si estás actualizando desde v8, ten en cuenta que la v9 no incluye cambios disr
 
 - [Guía de Paquetes Adaptadores de Compatibilidad](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/compat/index.md)
 - [Diccionarios Dinámicos - Colecciones y Variantes](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dynamic_dictionaries/index.md)
+- [Analytics - Seguimiento de exposición de contenido y pruebas A/B](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [Referencia de Configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md)
+- [SDK de CMS - Acceso programático con @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md)
+- [Guía de Auto-alojamiento](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/self_hosting.md)

package/docs/es/self_hosting.md

@@ -0,0 +1,350 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: Autoalojamiento de Intlayer
+description: Ejecuta una instancia completa de Intlayer en tu propia infraestructura con un solo comando. No se requiere una cuenta de Intlayer Cloud.
+keywords:
+  - Self-Hosting
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Installation
+  - Infrastructure
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Autoalojamiento de Intlayer
+
+Intlayer puede ejecutarse completamente en tu propia infraestructura, sin necesidad de una cuenta de Intlayer Cloud. Un solo comando inicia una pila lista para producción:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+El instalador descarga un `docker-compose.yml` y un `.env`, autogenera los secretos necesarios e inicia todos los contenedores con `docker compose up -d`.
+
+## Tabla de Contenidos
+
+<TOC/>
+
+---
+
+## Arquitectura
+
+```
+                ┌─────────────────────────────┐
+ navegador ──────▶ │  app  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  backend (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (RS de 1 nodo)             (API de S3)     (SMTP)        (en-imagen)
+                             minio:9001   mailpit:8025
+                             (consola)    (interfaz web)
+```
+
+Chromium (utilizado para la generación de capturas de pantalla de Puppeteer) se incluye dentro de la imagen del backend, no se necesita un contenedor separado.
+
+---
+
+## Requisitos previos
+
+- **Docker** ≥ 24 y **Docker Compose** ≥ v2. Si falta alguno, el instalador imprimirá el enlace de instalación y saldrá.
+- Puertos `3000`, `3100`, `8025`, `9000` y `9001` disponibles en el host.
+- Un host Linux o macOS (o WSL2 en Windows).
+
+---
+
+## Inicio rápido
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Lo que hace el instalador:
+
+1.  Verifica que `docker` y `docker compose` estén presentes.
+2.  Descarga `docker-compose.yml` y `.env.example` en `./intlayer/`.
+3.  Si no existe un `.env`, copia el ejemplo y genera secretos aleatorios para `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` y `S3_SECRET_ACCESS_KEY` a través de `openssl rand`.
+4.  Ejecuta `docker compose pull` + `docker compose up -d`.
+5.  Imprime las URLs: dashboard `:3000`, API `:3100`, interfaz de usuario de correo electrónico `:8025`, consola de MinIO `:9001`.
+
+Una vez que la pila esté en funcionamiento, abre **http://localhost:3000** y crea tu primera cuenta.
+
+---
+
+## Servicios
+
+| Servicio    | Imagen                                     | Puerto(s) del host                   | Propósito                                                                        |
+| :---------- | :----------------------------------------- | :----------------------------------- | :------------------------------------------------------------------------------- |
+| **app**     | construido desde `apps/app/Dockerfile`     | `3000`                               | Dashboard de TanStack Start (UI del CMS)                                         |
+| **backend** | construido desde `apps/backend/Dockerfile` | `3100`                               | API REST de Fastify (endpoint `/health`)                                         |
+| **mongo**   | `mongo:7`                                  | interno                              | Conjunto de réplicas de un solo nodo (`rs0`)                                     |
+| **redis**   | `redis:7-alpine`                           | interno                              | Colas de trabajos (BullMQ) y almacenamiento en caché (ioredis)                   |
+| **minio**   | `minio/minio`                              | `9000` (S3), `9001` (consola)        | Almacenamiento de objetos compatible con S3 para avatares y capturas de pantalla |
+| **mailpit** | `axllent/mailpit`                          | `1025` (SMTP), `8025` (interfaz web) | Receptor local de correos electrónicos transaccionales                           |
+
+Los puertos internos (mongo, redis) no se exponen al host por defecto.
+
+> El puerto `9000` de MinIO debe ser accesible desde el navegador porque los activos cargados (avatares, capturas de pantalla) se cargan directamente desde `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
+
+---
+
+## Variables de entorno
+
+El instalador genera un archivo `.env` listo para usar. La siguiente tabla describe cada variable.
+
+### Requeridas (autogeneradas o solicitadas)
+
+| Variable               | Ejemplo                                         | Descripción                                                         |
+| :--------------------- | :---------------------------------------------- | :------------------------------------------------------------------ |
+| `NODE_ENV`             | `production`                                    | Entorno de ejecución                                                |
+| `PORT`                 | `3100`                                          | Puerto de escucha del backend                                       |
+| `BACKEND_URL`          | `http://localhost:3100`                         | URL pública de la API del backend                                   |
+| `APP_URL`              | `http://localhost:3000`                         | URL pública del dashboard                                           |
+| `DOMAIN`               | `localhost`                                     | Dominio de la cookie                                                |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | URI de conexión completa de MongoDB                                 |
+| `REDIS_URL`            | `redis://redis:6379`                            | URL de conexión de Redis                                            |
+| `BETTER_AUTH_SECRET`   | _(generado)_                                    | Secreto de 32 bytes para la firma de sesiones                       |
+| `MAIL_PROVIDER`        | `smtp`                                          | Transporte de correo: `smtp` o `resend`                             |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | Nombre de host SMTP (nombre del contenedor de Mailpit)              |
+| `MAIL_SMTP_PORT`       | `1025`                                          | Puerto SMTP                                                         |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Dirección del remitente                                             |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | Endpoint compatible con S3                                          |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | URL pública para la carga de activos del navegador                  |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Nombre del bucket                                                   |
+| `S3_ACCESS_KEY_ID`     | _(generado)_                                    | Clave de acceso de MinIO                                            |
+| `S3_SECRET_ACCESS_KEY` | _(generado)_                                    | Clave secreta de MinIO                                              |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | URL del backend integrada en el dashboard en tiempo de construcción |
+| `VITE_DOMAIN`          | `localhost`                                     | Dominio integrado en el dashboard en tiempo de construcción         |
+
+### Opcionales (las características se degradan elegantemente cuando están ausentes)
+
+| Variable                                                 | Característica                                                                          |
+| :------------------------------------------------------- | :-------------------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | Traducción asistida por IA y auditoría de contenido                                     |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Gestión de facturación y suscripciones                                                  |
+| `RESEND_API_KEY`                                         | Correo electrónico transaccional a través de Resend (anula Mailpit cuando se configura) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | Inicio de sesión GitHub OAuth                                                           |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Inicio de sesión Google OAuth                                                           |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | Inicio de sesión GitLab OAuth                                                           |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Inicio de sesión Microsoft OAuth                                                        |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Inicio de sesión LinkedIn OAuth                                                         |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Inicio de sesión Atlassian OAuth                                                        |
+
+---
+
+## Conectando tu proyecto Intlayer
+
+Una vez que la pila esté en funcionamiento, apunta tu proyecto al backend y dashboard autoalojados en lugar de `intlayer.org`.
+
+### Configuración del proyecto
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+
+    /**
+     * URL del dashboard CMS autoalojado.
+     * Por defecto: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000
+
+    /**
+     * URL de la API del backend autoalojado.
+     * Por defecto: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Establece las variables de entorno en el `.env` de tu proyecto:
+
+```sh
+INTLAYER_CMS_URL=http://localhost:3000
+INTLAYER_BACKEND_URL=http://localhost:3100
+INTLAYER_CLIENT_ID=<your-client-id>
+INTLAYER_CLIENT_SECRET=<your-client-secret>
+```
+
+Crea credenciales de acceso en tu dashboard autoalojado en **Proyectos → Claves de acceso** en `http://localhost:3000/projects`.
+
+### SDK de `@intlayer/api`
+
+Al usar el SDK de `@intlayer/api` programáticamente, pasa `backendURL` explícitamente:
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cms = createIntlayerCMS({
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100
+  },
+});
+
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+```
+
+---
+
+## Actualización
+
+Volver a ejecutar el instalador en un despliegue existente realiza una actualización continua:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Esto descarga las últimas imágenes y reinicia los contenedores con `docker compose pull && docker compose up -d`. Los volúmenes existentes (`mongo-data`, `redis-data`, `minio-data`) se conservan, sin pérdida de datos.
+
+Para actualizar manualmente desde el directorio `./intlayer/`:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Copia de seguridad y restauración
+
+Todos los datos persistentes residen en tres volúmenes de Docker con nombre.
+
+### Copia de seguridad
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/mongo-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_redis-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/redis-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_minio-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/minio-data.tar.gz /data
+```
+
+### Restauración
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# Repetir para redis-data y minio-data
+```
+
+---
+
+## Uso de un proxy inverso (Nginx / Caddy)
+
+Para despliegues de producción, coloca un proxy inverso delante de los contenedores de la aplicación y del backend en lugar de exponerlos directamente.
+
+### Ejemplo de Nginx
+
+```nginx
+server {
+    listen 80;
+    server_name cms.example.com;
+
+    location / {
+        proxy_pass http://localhost:3000;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+
+server {
+    listen 80;
+    server_name api.example.com;
+
+    location / {
+        proxy_pass http://localhost:3100;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+Actualiza las siguientes variables `.env` para que coincidan con tus dominios públicos:
+
+```sh
+BACKEND_URL=https://api.example.com
+APP_URL=https://cms.example.com
+DOMAIN=example.com
+VITE_BACKEND_URL=https://api.example.com
+VITE_DOMAIN=example.com
+```
+
+> Las variables `VITE_*` se integran en la imagen del dashboard en el momento de la construcción. Si las cambias después de que se construya la imagen, necesitas reconstruir la imagen de la `app` (`docker compose build app`) o usar la inyección de configuración en tiempo de ejecución.
+
+---
+
+## Solución de problemas
+
+### Reinicios del backend en bucle al inicio
+
+MongoDB y Redis deben estar saludables antes de que el backend se inicie. El archivo compose utiliza `depends_on` con `condition: service_healthy`. Si ves reinicios repetidos del backend, verifica que los healthchecks de `mongo` y `redis` pasen:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### El dashboard no puede conectar con la API
+
+Verifica que `VITE_BACKEND_URL` coincida con la URL donde el backend es accesible desde el **navegador** (no desde la red de Docker). Si cambiaste el puerto del backend o añadiste un proxy inverso, reconstruye la imagen del dashboard:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### El correo electrónico no se envía
+
+Por defecto, todos los correos electrónicos salientes son capturados por Mailpit. Abre `http://localhost:8025` para ver los mensajes enviados. Para enviar correos electrónicos reales, establece `MAIL_PROVIDER=resend` y `RESEND_API_KEY=<tu-clave>` en `.env`, luego reinicia el backend:
+
+```sh
+docker compose restart backend
+```
+
+### Falta el bucket de MinIO
+
+Si el servicio de un solo uso `minio-init` no se ejecutó (o se ejecutó antes de que MinIO estuviera listo), crea el bucket manualmente:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Enlaces útiles
+
+- [Documentación del CMS de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md)
+- [Referencia de configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md)
+- [SDK del CMS — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md#programmatic-access-con-el-sdk-intlayerapi)
+- [Docker Image (aymercizip/intlayer-selfhost)](https://hub.docker.com/repository/docker/aymercizip/intlayer-selfhost/general)

package/docs/fr/bundle_optimization.md

@@ -231,6 +231,9 @@ Next.js nécessite le plugin `@intlayer/swc` pour la passe d'optimisation (réé
 
 > Ce plugin n'est pas installé par défaut car les plugins SWC sont encore expérimentaux pour Next.js. Cela pourrait changer à l'avenir.
 
+<Tabs>
+ <Tab value="npm">
+
 ```bash packageManager="npm"
 npm install -D @intlayer/swc
 ```
@@ -247,6 +250,19 @@ pnpm add -D @intlayer/swc
 bun add -d @intlayer/swc
 ```
 
+ </Tab>
+ <Tab value="Crates.io (rust)">
+
+```toml fileName="Cargo.toml"
+[dependencies]
+intlayer-swc-plugin = "*"
+```
+
+[View on Crates.io](https://crates.io/crates/intlayer-swc-plugin)
+
+ </Tab>
+</Tabs>
+
 Une fois installé, Intlayer détectera et utilisera automatiquement le plugin.
 
 Pour les passes de **purge et de minification** (suppression de champs et renommage de champs), installez `@intlayer/babel` en parallèle et ajoutez les plugins Babel. Parce que Next.js utilise SWC pour la transformation mais évalue toujours `babel.config.js` pour la configuration des plugins, les plugins Babel s'exécutent en tant que pré-passe avant SWC.

package/docs/fr/cli/index.md

@@ -125,7 +125,7 @@ Pour voir comment configurer les locales disponibles ou d'autres paramètres, re
 
 ### Authentification
 
-- **[Connexion](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/login.md)** - S'authentifier auprès du CMS Intlayer et obtenir les identifiants d'accès
+- **[Connexion](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/login.md)** - S'authentifier auprès du CMS Intlayer et obtenir les identifiants d'accès
 
 ### Commandes principales