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.
En esta página
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, sin usar main no publicado. La base de Ardo es su etiqueta 6.5.0.
¿Qué flujo de trabajo encaja?
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 separa tus archivos de la dependencia del framework; las actualizaciones no sobrescriben sin más tu sitio.
Comparación de funciones
| Á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. |
| 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. |
| Referencia de API | Referencia TypeScript nativa y generador estático de OpenAPI local. | OpenAPI 3.x, 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. |
| 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; las versiones de API tienen su propio modelo. |
| Búsqueda | MiniSearch integrado con índices generados. | Búsqueda Pagefind 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, con servicios opcionales para agentes. |
| MCP | Sin endpoint MCP en tiempo de ejecución proporcionado por el framework. | MCP remoto 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, con correcciones y comprobaciones de actualizaciones. |
| Recetas | ardo add muestra recetas de la misma versión, sin escribir archivos. | add 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; el renderizado bajo demanda y MCP remoto necesitan un adaptador de servidor. |
La guía de API, la configuración, la internacionalización y las instrucciones para agentes 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
| 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 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 y verifica las rutas publicadas, los enlaces y los ejemplos en una vista previa de producción.
Carencias y trabajo en curso
Nimbus también admite fuentes de contenido Git y builds parciales. Las propuestas correspondientes para Ardo siguen siendo #473 y #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, #470, #472 y #475. Las imágenes de vista previa automáticas se siguen en #471; no forman parte de la versión publicada 6.5.0 usada aquí.