# Ardo vs Nimbus

Compara los flujos de documentación de React y Astro, la propiedad de la interfaz, las referencias de API, los servicios para agentes y las migraciones.

Source: https://ardo-docs.dev/es/compare/nimbus

Ardo y Nimbus conservan la documentación en tu repositorio y publican HTML estático y Markdown para agentes. La elección depende del modelo de componentes, de quién mantiene los archivos de interfaz y del tipo de referencia de API que necesitas.

Verificado el **10 de noviembre de 2026** con las versiones publicadas **Ardo 6.5.0**, **Nimbus 0.19.4** y el **generador de proyectos Nimbus 0.8.3**. Las fuentes de Nimbus están fijadas al [commit de publicación de 0.19.4](https://github.com/cloudflare/nimbus/tree/980cee6da75f81982552b68a3607c0a19ee11987), sin usar main no publicado. La base de Ardo es su [etiqueta 6.5.0](https://github.com/sebastian-software/ardo/tree/ardo-v6.5.0).

## ¿Qué flujo de trabajo encaja? {#which-workflow-fits}

Elige Ardo si la documentación y los ejemplos deben compartir un modelo de componentes React, la API procede de TypeScript y prefieres actualizar una interfaz distribuida en un paquete. Sigues pudiendo crear componentes raíz y diseños React propios.

Elige Nimbus si controlar los archivos de diseño, componentes y estilos es esencial para tu trabajo, o si necesitas su referencia OpenAPI más completa y sus servicios opcionales para agentes en el servidor. Su [estructura de proyecto](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/project-structure.mdx) separa tus archivos de la dependencia del framework; las actualizaciones no sobrescriben sin más tu sitio.

## Comparación de funciones {#feature-comparison}

| Área | Ardo 6.5.0 | Nimbus 0.19.4 |
| --- | --- | --- |
| Modelo de página | Páginas React y MDX, prerenderizadas e hidratadas; navegación normal entre documentos. | Páginas Astro y MDX. Los componentes interactivos de frameworks usan [islas Astro](https://docs.astro.build/en/concepts/islands/). |
| Propiedad de la interfaz | La interfaz viene en el paquete; compónla o sustitúyela con React. | Los diseños, componentes y estilos generados están en [tu repositorio](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/project-structure.mdx). |
| Referencia de API | Referencia TypeScript nativa y generador estático de OpenAPI local. | [OpenAPI 3.x](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/api-reference/index.mdx), con operaciones, esquemas, versiones de API e interfaz de referencia específicos. |
| Lenguajes | Árboles estáticos completos por idioma; los cuatro idiomas de este sitio usan catálogos Palamedes. | Nimbus expone un idioma de documento para todo el sitio; las rutas por idioma y las traducciones corresponden al [proyecto Astro](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/packages/nimbus-docs/src/types.ts). |
| Control de versiones | Instantáneas estáticas por versión principal; los directorios de guías/API pueden versionarse independientemente de las páginas del sitio. | Colecciones y rutas separadas para [versiones anteriores de la documentación](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/navigation/versioning.mdx); las versiones de API tienen su propio modelo. |
| Búsqueda | MiniSearch integrado con índices generados. | [Búsqueda Pagefind](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/navigation/search.mdx) estática o un proveedor definido por el proyecto. |
| Archivos para agentes | Markdown por página, llms.txt, llms-full.txt y descubrimiento opcional de Agent Skills. | [Markdown y llms.txt](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/ai/publish-markdown.mdx), con servicios opcionales para agentes. |
| MCP | Sin endpoint MCP en tiempo de ejecución proporcionado por el framework. | [MCP remoto](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/ai/remote-mcp.mdx) opcional: list\_pages y get\_page; necesita adaptador de servidor y SDK. |
| Comprobación y lint | ardo check sin build, ardo lint para contenidos y comprobaciones de enlaces internos durante el build. | [nimbus-docs check y lint](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/cli.mdx), con correcciones y comprobaciones de actualizaciones. |
| Recetas | ardo add muestra recetas de la misma versión, sin escribir archivos. | [add](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/cli.mdx) copia el código de los componentes; las funciones entregan recetas a un agente. |
| JavaScript en el navegador | Hidratación React e interfaz interactiva; sin router de cliente. | Islas Astro con los componentes y scripts elegidos; el volumen transferido depende de esa composición. |
| Alojamiento | Archivos estáticos en cualquier alojamiento estático. | [Estático por defecto](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/deploy/other-hosts.mdx); el renderizado bajo demanda y MCP remoto necesitan un adaptador de servidor. |

La [guía de API](<https://ardo-docs.dev/v6/es/guide/api-documentation/>), la [configuración](<https://ardo-docs.dev/v6/es/guide/configuration/>), la [internacionalización](<https://ardo-docs.dev/v6/es/guide/internationalization/>) y las [instrucciones para agentes](<https://ardo-docs.dev/v6/es/guide/agent-instructions/>) de Ardo explican su parte de la tabla. Nimbus aún no ha llegado a la versión 1.0; consulta sus notas antes de suponer que una versión menor posterior se comporta igual.

## Migrar desde Nimbus {#coming-from-nimbus}

| Proyecto Nimbus | Equivalente en Ardo o trabajo de migración |
| --- | --- |
| src/content/docs/ | Mueve los textos a app/routes/, con directorios de idioma y guide si están configurados. Conserva las URL antiguas mediante redirecciones explícitas. |
| title, description, sidebar.order | Conserva title y description; cambia sidebar.order por order. Revisa los demás campos de [frontmatter](<https://ardo-docs.dev/v6/es/guide/frontmatter/>) individualmente. |
| mode: custom | Usa layout: bare para una página sin el marco de documentación. |
| src/components.ts y componentes Astro | Revisa cada componente y sus props; porta el código Astro a React o usa los componentes MDX de Ardo. No hay conversión automática de componentes. |
| astro.config.ts y nimbus() | Usa ardo.config.ts para las opciones del framework y los plugins Vite propios, y app/root.tsx para componer la interfaz. |
| Referencias OpenAPI | Empieza con la configuración openapi local de Ardo. Las versiones de API, las vistas de esquemas y los controles interactivos de referencia de Nimbus no se trasladan directamente. |

Revisa los borradores, las páginas ocultas y las reglas de publicación antes de mover el contenido; los indicadores de Nimbus no conservan automáticamente su significado en Ardo. Sigue las [instrucciones de instalación](<https://ardo-docs.dev/v6/es/guide/agent-instructions/>) y verifica las rutas publicadas, los enlaces y los ejemplos en una vista previa de producción.

## Carencias y trabajo en curso {#gaps-and-current-work}

Nimbus también admite [fuentes de contenido Git](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/content-sources/git.mdx) y [builds parciales](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/publish/partial-builds.mdx). Las propuestas correspondientes para Ardo siguen siendo [#473](https://github.com/sebastian-software/ardo/issues/473) y [#474](https://github.com/sebastian-software/ardo/issues/474). Ya puedes hacer un checkout en CI y mapear el contenido local.

Los componentes de autoría, los comandos check/lint, el renderizado estático de Mermaid y las recetas de Ardo ya están implementados: [#469](https://github.com/sebastian-software/ardo/issues/469), [#470](https://github.com/sebastian-software/ardo/issues/470), [#472](https://github.com/sebastian-software/ardo/issues/472) y [#475](https://github.com/sebastian-software/ardo/issues/475). Las imágenes de vista previa automáticas se siguen en [#471](https://github.com/sebastian-software/ardo/issues/471); no forman parte de la versión publicada 6.5.0 usada aquí.
