@intlayer/docs 8.11.2 → 8.12.0-canary.0

package/docs/es/intlayer_with_tanstack+solid.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-03-25
-updatedAt: 2026-05-06
-title: i18n Tanstack Start - Cómo traducir una aplicación Tanstack Start usando Solid.js en 2026
-description: Aprenda cómo agregar internacionalización (i18n) a su aplicación Tanstack Start usando Intlayer y Solid.js. Siga esta guía completa para hacer que su aplicación sea multilingüe con enrutamiento consciente de la localización.
+updatedAt: 2026-05-31
+title: "TanStack Start + Solid i18n - Guía completa para traducir tu aplicación"
+description: "Sin más i18next. La guía 2026 para crear una aplicación TanStack Start + Solid multilingüe (i18n). Traduce con agentes de IA y optimiza el tamaño del bundle, SEO y rendimiento."
 keywords:
   - Internacionalización
   - Documentación
@@ -38,17 +38,54 @@ history:
 
 Esta guía demuestra cómo integrar **Intlayer** para una internacionalización fluida en proyectos Tanstack Start con Solid.js, enrutamiento consciente de la localización, soporte de TypeScript y prácticas de desarrollo modernas.
 
-## ¿Qué es Intlayer?
+## ¿Por qué Intlayer en lugar de alternativas?
 
-**Intlayer** es una biblioteca de internacionalización (i18n) innovadora y de código abierto diseñada para simplificar el soporte multilingüe en aplicaciones web modernas.
+En comparación con soluciones principales como `react-i18next` o `i18next`, Intlayer es una solución que viene con optimizaciones integradas como:
 
-Con Intlayer, puede:
+<AccordionGroup>
 
-- **Gestionar fácilmente las traducciones** utilizando diccionarios declarativos a nivel de componente.
-- **Localizar dinámicamente metadatos**, rutas y contenido.
-- **Asegurar el soporte de TypeScript** con tipos autogenerados, mejorando el autocompletado y la detección de errores.
-- **Beneficiarse de funciones avanzadas**, como la detección y el cambio dinámico de idioma.
-- **Habilitar el enrutamiento consciente de la localización** con el sistema de enrutamiento basado en archivos de Tanstack Start.
+<Accordion header="Soporte completo de TanStack Start">
+
+Intlayer está optimizado para funcionar perfectamente con TanStack Start y Solid al ofrecer **enrutamiento multilingüe**, **mapa del sitio** y todas las funciones necesarias para escalar la internacionalización (i18n).
+
+</Accordion>
+
+<Accordion header="Tamaño del bundle">
+
+En lugar de cargar archivos JSON masivos en sus páginas, cargue solo el contenido necesario. Intlayer ayuda a **reducir el tamaño de su bundle y de sus páginas hasta en un 50%**.
+
+</Accordion>
+
+<Accordion header="Mantenibilidad">
+
+Determinar el alcance del contenido de su aplicación **facilita el mantenimiento** para aplicaciones a gran escala. Puede duplicar o eliminar una sola carpeta de funciones sin la carga mental de revisar todo el código base de contenido. Además, Intlayer está **completamente escrito** para garantizar la precisión de su contenido.
+
+</Accordion>
+
+<Accordion header="Agente de IA">
+
+La ubicación conjunta de contenido **reduce el contexto necesario** para los modelos de lenguajes grandes (LLM). Intlayer también viene con un conjunto de herramientas, como una **CLI** para comprobar si faltan traducciones,**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** y **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**, para que la experiencia del desarrollador (DX) sea aún más fluida para los agentes de IA.
+
+</Accordion>
+
+<Accordion header="Automatización">
+
+Utilice la automatización para traducir su canal de CI/CD utilizando el LLM de su elección al costo de su proveedor de IA. Intlayer también ofrece un **compilador** para automatizar la extracción de contenido, así como una [plataforma web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md) para ayudar a **traducir en segundo plano**.
+
+</Accordion>
+
+<Accordion header="Actuación">
+
+La conexión de archivos JSON masivos a componentes puede provocar problemas de rendimiento y reactividad. Intlayer optimiza la carga de su contenido en el momento de la compilación.
+
+</Accordion>
+
+<Accordion header="Escalando sin ningún desarrollador">
+
+Más que una simple solución i18n, Intlayer proporciona un **[editor visual] autohospedado(https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** y un **[CMS completo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)** para ayudarle a administrar su contenido multilingüe en **tiempo real**, lo que facilita la colaboración con traductores, redactores y otros miembros del equipo. El contenido se puede almacenar de forma local y/o remota.
+
+</Accordion>
+</AccordionGroup>
 
 ---
 
@@ -86,11 +123,15 @@ Con Intlayer, puede:
 
 Ver [Plantilla de aplicación](https://github.com/aymericzip/intlayer-tanstack-start-solid-template) en GitHub.
 
-### Paso 1: Crear el proyecto
+<Steps>
+
+<Step number={1} title="Crear el proyecto">
 
 Comience creando un nuevo proyecto TanStack Start siguiendo la guía [Iniciar nuevo proyecto](https://tanstack.com/start/latest/docs/framework/solid/quick-start) en el sitio web de TanStack Start.
 
-### Paso 2: Instalar los paquetes de Intlayer
+</Step>
+
+<Step number={2} title="Instalar los paquetes de Intlayer">
 
 Instale los paquetes necesarios utilizando su gestor de paquetes preferido:
 
@@ -128,7 +169,9 @@ bun x intlayer init
 - **vite-intlayer**
   Incluye el plugin de Vite para integrar Intlayer con el [bundler Vite](https://vite.dev/guide/why.html#why-bundle-for-production), así como el middleware para detectar el idioma preferido del usuario, gestionar cookies y manejar la redirección de URL.
 
-### Paso 3: Configuración de su proyecto
+</Step>
+
+<Step number={3} title="Configuración de su proyecto">
 
 Cree un archivo de configuración para configurar los idiomas de su aplicación:
 
@@ -149,7 +192,9 @@ export default config;
 
 > A través de este archivo de configuración, puede configurar URLs localizadas, redirección de middleware, nombres de cookies, la ubicación y extensión de sus declaraciones de contenido, desactivar los registros de Intlayer en la consola, y más. Para una lista completa de los parámetros disponibles, consulte la [documentación de configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md).
 
-### Paso 4: Integrar Intlayer en su configuración de Vite
+</Step>
+
+<Step number={4} title="Integrar Intlayer en su configuración de Vite">
 
 Añada el plugin de intlayer en su configuración:
 
@@ -177,7 +222,9 @@ export default defineConfig({
 
 > El plugin de Vite `intlayer()` se utiliza para integrar Intlayer con Vite. Asegura la construcción de los archivos de declaración de contenido y los monitoriza en modo de desarrollo. Define las variables de entorno de Intlayer dentro de la aplicación Vite. Además, proporciona alias para optimizar el rendimiento.
 
-### Paso 5: Crear el diseño raíz (Root Layout)
+</Step>
+
+<Step number={5} title="Crear el diseño raíz">
 
 Configure su diseño raíz para soportar la internacionalización utilizando `useParams` para detectar el idioma actual y estableciendo los atributos `lang` y `dir` en la etiqueta `html`.
 
@@ -218,7 +265,9 @@ const RootComponent: ParentComponent = (props) => {
 };
 ```
 
-### Paso 6: Crear el diseño de idioma (Opcional)
+</Step>
+
+<Step number={6} title="Crear el diseño de idioma">
 
 Cree un diseño que maneje el prefijo de idioma y realice la validación. Este diseño asegurará que solo se procesen idiomas válidos.
 
@@ -253,7 +302,9 @@ export const Route = createFileRoute("/{-$locale}")({
 > Para el modo `'prefix-all'`, puede preferir cambiar el hueco a `$locale` en su lugar.
 > Para el modo `'no-prefix'` o `'search-params'`, puede eliminar el hueco por completo.
 
-### Paso 7: Declarar su contenido
+</Step>
+
+<Step number={7} title="Declarar su contenido">
 
 Cree y gestione sus declaraciones de contenido para almacenar traducciones:
 
@@ -299,7 +350,9 @@ export default appContent;
 
 > Para más detalles, consulte la [documentación de declaración de contenido](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/content_file.md).
 
-### Paso 8: Utilizar componentes y hooks conscientes del idioma
+</Step>
+
+<Step number={8} title="Utilizar componentes y hooks conscientes del idioma">
 
 Cree un componente `LocalizedLink` para una navegación consciente del idioma:
 
@@ -378,7 +431,9 @@ export const useLocalizedNavigate = () => {
 };
 ```
 
-### Paso 9: Utilizar Intlayer en sus páginas
+</Step>
+
+<Step number={9} title="Utilizar Intlayer en sus páginas">
 
 Acceda a sus diccionarios de contenido en toda su aplicación:
 
@@ -421,7 +476,9 @@ function RouteComponent() {
 >
 > Para saber más sobre el hook `useIntlayer`, consulte la [documentación](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/solid-intlayer/useIntlayer.md).
 
-### Paso 10: Crear un componente selector de idioma (Locale Switcher)
+</Step>
+
+<Step number={10} title="Crear un componente selector de idioma">
 
 Cree un componente para permitir a los usuarios cambiar de idioma:
 
@@ -465,7 +522,9 @@ export default LocaleSwitcher;
 >
 > Para saber más sobre el hook `useLocale`, consulte la [documentación](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/solid-intlayer/useLocale.md).
 
-### Paso 11: Gestión de atributos HTML
+</Step>
+
+<Step number={11} title="Gestión de atributos HTML">
 
 Como vimos en el Paso 5, puede gestionar los atributos `lang` y `dir` de la etiqueta `html` utilizando `useParams` en su componente raíz. Esto asegura que se establezcan los atributos correctos tanto en el servidor como en el cliente.
 
@@ -484,7 +543,9 @@ const RootComponent: ParentComponent = (props) => {
 
 ---
 
-### Paso 12: Añadir middleware (Opcional)
+</Step>
+
+<Step number={12} title="Añadir middleware">
 
 También puede utilizar `intlayerProxy` para añadir enrutamiento del lado del servidor a su aplicación. Este plugin detectará automáticamente el idioma actual basándose en la URL y establecerá la cookie de idioma adecuada. Si no se especifica ningún idioma, el plugin determinará el idioma más apropiado basándose en las preferencias de idioma del navegador del usuario. Si no se detecta ningún idioma, redirigirá al idioma predeterminado.
 
@@ -515,7 +576,9 @@ export default defineConfig({
 
 ---
 
-### Paso 13: Internacionalizar sus metadatos (Opcional)
+</Step>
+
+<Step number={13} title="Internacionalizar sus metadatos">
 
 También puede utilizar la función `getIntlayer` para acceder a sus diccionarios de contenido dentro del cargador `head` para metadatos conscientes de la localización:
 
@@ -562,7 +625,9 @@ export const Route = createFileRoute("/{-$locale}/")({
 
 ---
 
-### Paso 13: Recuperar el idioma en sus acciones de servidor (Opcional)
+</Step>
+
+<Step number={13} title="Recuperar el idioma en sus acciones de servidor">
 
 Es posible que desee acceder al idioma actual desde sus acciones de servidor o endpoints de API.
 Puede hacerlo utilizando el ayudante `getLocale` de `intlayer`.
@@ -599,7 +664,9 @@ export const getLocaleServer = createServerFn().handler(async () => {
 
 ---
 
-### Paso 14: Gestionar páginas no encontradas (Opcional)
+</Step>
+
+<Step number={14} title="Gestionar páginas no encontradas">
 
 Cuando un usuario visita una página inexistente, puede mostrar una página 404 personalizada y el prefijo de idioma puede afectar a la forma en que se activa la página no encontrada.
 
@@ -673,7 +740,9 @@ export const Route = createFileRoute("/{-$locale}/$")({
 });
 ```
 
-### (Opcional) Paso 15: Extraer el contenido de sus componentes
+</Step>
+
+<Step number={15} title="Extraer el contenido de sus componentes" isOptional={true}>
 
 Si tiene una base de código existente, transformar miles de archivos puede llevar mucho tiempo.
 
@@ -786,7 +855,9 @@ bun run build # O bun run dev
 
 ---
 
-### Paso 16: Generar un Sitemap (Opcional)
+</Step>
+
+<Step number={16} title="Generar un Sitemap">
 
 Intlayer viene con un generador de sitemap integrado para ayudarte a crear fácilmente un sitemap para tu aplicación. Maneja las rutas localizadas y agrega los metadatos necesarios para los motores de búsqueda.
 
@@ -859,7 +930,9 @@ export const Route = createFileRoute("/sitemap.xml")({
 
 ---
 
-### Paso 17: Configurar TypeScript (Opcional)
+</Step>
+
+<Step number={17} title="Configurar TypeScript">
 
 Intlayer utiliza el aumento de módulos para aprovechar las ventajas de TypeScript y hacer que su base de código sea más robusta.
 
@@ -877,6 +950,10 @@ Asegúrese de que su configuración de TypeScript incluya los tipos autogenerado
 
 ---
 
+</Step>
+
+</Steps>
+
 ### Configuración de Git
 
 Se recomienda ignorar los archivos generados por Intlayer. Esto le permite evitar subirlos a su repositorio Git.

package/docs/es/intlayer_with_tanstack.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-05-06
-title: Tanstack Start i18n - Cómo traducir una aplicación Tanstack Start en 2026
-description: Aprende a añadir la internacionalización (i18n) a tu aplicación Tanstack Start utilizando Intlayer. Sigue esta guía completa para hacer que tu aplicación sea multilingüe con enrutamiento consciente de la configuración regional.
+updatedAt: 2026-05-31
+title: "TanStack Start i18n - Guía completa para traducir tu aplicación"
+description: "Sin más i18next. La guía 2026 para crear una aplicación TanStack Start multilingüe (i18n). Traduce con agentes de IA y optimiza el tamaño del bundle, SEO y rendimiento."
 keywords:
   - Internacionalización
   - Documentación
@@ -55,17 +55,54 @@ history:
 
 Esta guía demuestra cómo integrar **Intlayer** para una internacionalización fluida en proyectos Tanstack Start con enrutamiento consciente de la configuración regional, soporte para TypeScript y prácticas de desarrollo modernas.
 
-## ¿Qué es Intlayer?
+## ¿Por qué Intlayer en lugar de alternativas?
 
-**Intlayer** es una biblioteca de internacionalización (i18n) innovadora y de código abierto diseñada para simplificar el soporte multilingüe en aplicaciones web modernas.
+En comparación con soluciones principales como `react-i18next` o `use-intl`, o `paraglide`, Intlayer es una solución que viene con optimizaciones integradas como:
 
-Con Intlayer, puedes:
+<AccordionGroup>
 
-- **Gestionar fácilmente las traducciones** utilizando diccionarios declarativos a nivel de componente.
-- **Localizar dinámicamente metadatos**, rutas y contenido.
-- **Garantizar el soporte de TypeScript** con tipos autogenerados, mejorando el autocompletado y la detección de errores.
-- **Beneficiarte de funciones avanzadas**, como la detección y el cambio dinámico de la configuración regional.
-- **Habilitar el enrutamiento consciente de la configuración regional** con el sistema de enrutamiento basado en archivos de Tanstack Start.
+<Accordion header="Soporte completo de TanStack Start">
+
+Intlayer está completamente optimizado para TanStack Start y proporciona **enrutamiento multilingüe**, **administración de cookies**, **generación de mapas de sitio**, **carga de contenido dinámico** y todas las funciones necesarias para escalar sus esfuerzos de internacionalización (i18n).
+
+</Accordion>
+
+<Accordion header="Tamaño del bundle">
+
+En lugar de cargar archivos JSON masivos en sus páginas, cargue solo el contenido necesario. Intlayer ayuda a **reducir el tamaño de su bundle y de sus páginas hasta en un 50%**.
+
+</Accordion>
+
+<Accordion header="Mantenibilidad">
+
+Determinar el alcance del contenido de su aplicación **facilita el mantenimiento** para aplicaciones a gran escala. Puede duplicar o eliminar una sola carpeta de funciones sin la carga mental de revisar todo el código base de contenido. Además, Intlayer está **completamente escrito** para garantizar la precisión de su contenido.
+
+</Accordion>
+
+<Accordion header="Agente de IA">
+
+La ubicación conjunta de contenido **reduce el contexto necesario** para los modelos de lenguajes grandes (LLM). Intlayer también viene con un conjunto de herramientas, como una **CLI** para comprobar si faltan traducciones,**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** y **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**, para que la experiencia del desarrollador (DX) sea aún más fluida para los agentes de IA.
+
+</Accordion>
+
+<Accordion header="Automatización">
+
+Utilice la automatización para traducir su canal de CI/CD utilizando el LLM de su elección al costo de su proveedor de IA. Intlayer también ofrece un **compilador** para automatizar la extracción de contenido, así como una [plataforma web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md) para ayudar a **traducir en segundo plano**.
+
+</Accordion>
+
+<Accordion header="Actuación">
+
+La conexión de archivos JSON masivos a componentes puede provocar problemas de rendimiento y reactividad. Intlayer optimiza la carga de su contenido en el momento de la compilación.
+
+</Accordion>
+
+<Accordion header="Escalando sin ningún desarrollador">
+
+Más que una simple solución i18n, Intlayer proporciona un **[editor visual] autohospedado(https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** y un **[CMS completo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)** para ayudarle a administrar su contenido multilingüe en **tiempo real**, lo que facilita la colaboración con traductores, redactores y otros miembros del equipo. El contenido se puede almacenar de forma local y/o remota.
+
+</Accordion>
+</AccordionGroup>
 
 ---
 
@@ -103,11 +140,15 @@ Con Intlayer, puedes:
 
 Consulta la [Plantilla de Aplicación](https://github.com/aymericzip/intlayer-tanstack-start-template) en GitHub.
 
-### Paso 1: Crear proyecto
+<Steps>
+
+<Step number={1} title="Crear proyecto">
 
 Comienza creando un nuevo proyecto TanStack Start siguiendo la guía [Start new project](https://tanstack.com/start/latest/docs/framework/react/quick-start) en el sitio web de TanStack Start.
 
-### Paso 2: Instalar paquetes de Intlayer
+</Step>
+
+<Step number={2} title="Instalar paquetes de Intlayer">
 
 Instala los paquetes necesarios utilizando tu gestor de paquetes preferido:
 
@@ -145,7 +186,9 @@ bun x intlayer init
 - **vite-intlayer**
   Incluye el plugin de Vite para integrar Intlayer con el [empaquetador Vite](https://vite.dev/guide/why.html#why-bundle-for-production), así como el middleware para detectar la configuración regional preferida del usuario, gestionar cookies y manejar la redirección de URL.
 
-### Paso 3: Configuración de tu proyecto
+</Step>
+
+<Step number={3} title="Configuración de tu proyecto">
 
 Crea un archivo de configuración para configurar los idiomas de tu aplicación:
 
@@ -166,7 +209,9 @@ export default config;
 
 > A través de este archivo de configuración, puedes establecer URLs localizadas, redirección de middleware, nombres de cookies, la ubicación y extensión de tus declaraciones de contenido, desactivar los registros de Intlayer en la consola y más. Para obtener una lista completa de los parámetros disponibles, consulta la [documentación de configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md).
 
-### Paso 4: Integrar Intlayer en tu configuración de Vite
+</Step>
+
+<Step number={4} title="Integrar Intlayer en tu configuración de Vite">
 
 Añade el plugin intlayer en tu configuración:
 
@@ -196,7 +241,9 @@ export default config;
 
 > El plugin de Vite `intlayer()` se utiliza para integrar Intlayer con Vite. Asegura la construcción de los archivos de declaración de contenido y los monitorea en modo desarrollo. Define variables de entorno de Intlayer dentro de la aplicación Vite. Además, proporciona alias para optimizar el rendimiento.
 
-### Paso 5: Crear el diseño raíz (Root Layout)
+</Step>
+
+<Step number={5} title="Crear el diseño raíz">
 
 Configura tu diseño raíz para admitir la internacionalización mediante el uso de `useParams` para detectar la configuración regional actual y estableciendo los atributos `lang` y `dir` en la etiqueta `html`.
 
@@ -256,7 +303,9 @@ function RootDocument({ children }: { children: ReactNode }) {
 > <img src="{String(content.image.src)}" alt="{String(content.image)}" />
 > ```
 
-### Paso 6: Crear el diseño de configuración regional (Locale Layout)
+</Step>
+
+<Step number={6} title="Crear el diseño de configuración regional">
 
 Crea un diseño que maneje el prefijo de configuración regional y realice la validación.
 
@@ -288,7 +337,9 @@ export const Route = createFileRoute("/{-$locale}")({
 > Para el modo `'prefix-all'`, es posible que prefieras cambiar el espacio a `$locale` en su lugar.
 > Para el modo `'no-prefix'` o `'search-params'`, puedes eliminar el espacio por completo.
 
-### Paso 7: Declarar tu contenido
+</Step>
+
+<Step number={7} title="Declarar tu contenido">
 
 Crea y gestiona tus declaraciones de contenido para almacenar traducciones:
 
@@ -334,7 +385,9 @@ export default appContent;
 
 > Para más detalles, consulta la [documentación de declaración de contenido](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/content_file.md).
 
-### Paso 7: Crear componentes y hooks conscientes de la configuración regional
+</Step>
+
+<Step number={7} title="Crear componentes y hooks conscientes de la configuración regional">
 
 Crea un componente `LocalizedLink` para la navegación consciente de la configuración regional:
 
@@ -438,7 +491,9 @@ export const useLocalizedNavigate = () => {
 };
 ```
 
-### Paso 8: Utilizar Intlayer en tus páginas
+</Step>
+
+<Step number={8} title="Utilizar Intlayer en tus páginas">
 
 Accede a tus diccionarios de contenido en toda tu aplicación:
 
@@ -486,7 +541,9 @@ function RouteComponent() {
 
 > Para obtener más información sobre el hook `useIntlayer`, consulta la [documentación](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/react-intlayer/useIntlayer.md).
 
-### Paso 9: Crear un componente selector de idioma (Locale Switcher)
+</Step>
+
+<Step number={9} title="Crear un componente selector de idioma">
 
 Crea un componente para permitir a los usuarios cambiar de idioma:
 
@@ -547,7 +604,9 @@ export const LocaleSwitcher: FC = () => {
 
 > Para obtener más información sobre el hook `useLocale`, consulta la [documentación](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/react-intlayer/useLocale.md).
 
-### Paso 10: Gestión de atributos HTML
+</Step>
+
+<Step number={10} title="Gestión de atributos HTML">
 
 Como se vio en el Paso 5, puedes gestionar los atributos `lang` y `dir` de la etiqueta `html` utilizando `useParams` en tu componente raíz. Esto garantiza que los atributos correctos se establezcan en el servidor y el cliente.
 
@@ -566,7 +625,9 @@ function RootDocument({ children }: { children: ReactNode }) {
 
 ---
 
-### Paso 11: Añadir middleware (Opcional)
+</Step>
+
+<Step number={11} title="Añadir middleware">
 
 También puedes usar el `intlayerProxy` para añadir enrutamiento del lado del servidor a tu aplicación. Este plugin detectará automáticamente la configuración regional actual basada en la URL y establecerá la cookie de configuración regional adecuada. Si no se especifica ninguna configuración regional, el plugin determinará la más adecuada según las preferencias de idioma del navegador del usuario. Si no se detecta ninguna, redirigirá a la configuración regional predeterminada.
 
@@ -597,7 +658,9 @@ export default defineConfig({
 
 ---
 
-### Paso 12: Internacionalizar tus metadatos (Opcional)
+</Step>
+
+<Step number={12} title="Internacionalizar tus metadatos">
 
 También puedes usar el hook `getIntlayer` para acceder a tus diccionarios de contenido en toda tu aplicación:
 
@@ -644,7 +707,9 @@ export const Route = createFileRoute("/{-$locale}/")({
 
 ---
 
-### Paso 13: Recuperar la configuración regional en tus acciones del servidor (Opcional)
+</Step>
+
+<Step number={13} title="Recuperar la configuración regional en tus acciones del servidor">
 
 Es posible que desees acceder a la configuración regional actual desde dentro de tus acciones del servidor o endpoints de la API.
 Puedes hacerlo utilizando el asistente `getLocale` de `intlayer`.
@@ -681,7 +746,9 @@ export const getLocaleServer = createServerFn().handler(async () => {
 
 ---
 
-### Paso 14: Gestionar páginas no encontradas (Opcional)
+</Step>
+
+<Step number={14} title="Gestionar páginas no encontradas">
 
 Cuando un usuario visita una página que no existe, puedes mostrar una página de no encontrado personalizada y el prefijo de configuración regional puede afectar la forma en que se activa la página de no encontrado.
 
@@ -757,7 +824,9 @@ export const Route = createFileRoute("/{-$locale}/$")({
 
 ---
 
-### (Opcional) Paso 15 : Extraer el contenido de tus componentes
+</Step>
+
+<Step number={15} title="Extraer el contenido de tus componentes" isOptional={true}>
 
 Si tienes una base de código existente, transformar miles de archivos puede llevar mucho tiempo.
 
@@ -855,7 +924,9 @@ bun run build # Or bun run dev
 
 ---
 
-### Paso 16: Generar un Sitemap (Opcional)
+</Step>
+
+<Step number={16} title="Generar un Sitemap">
 
 Intlayer viene con un generador de sitemap integrado para ayudarte a crear fácilmente un sitemap para tu aplicación. Maneja las rutas localizadas y agrega los metadatos necesarios para los motores de búsqueda.
 
@@ -930,7 +1001,9 @@ export const Route = createFileRoute("/sitemap.xml")({
 
 ---
 
-### Paso 17: Configurar TypeScript (Opcional)
+</Step>
+
+<Step number={17} title="Configurar TypeScript">
 
 Intlayer utiliza la ampliación de módulos para obtener los beneficios de TypeScript y fortalecer tu base de código.
 
@@ -948,6 +1021,10 @@ Asegúrate de que tu configuración de TypeScript incluya los tipos autogenerado
 
 ---
 
+</Step>
+
+</Steps>
+
 ### Configuración de Git
 
 Se recomienda ignorar los archivos generados por Intlayer. Esto te permite evitar confirmarlos en tu repositorio de Git.