# Ardo vs Nimbus

Vergleiche Dokumentationsabläufe mit React und Astro, UI-Zuständigkeiten, API-Referenzen, Agent-Dienste und Migrationswege.

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

Ardo und Nimbus halten Dokumentation im Repository und veröffentlichen statisches HTML sowie Markdown für Agenten. Entscheidend sind das Komponentenmodell, die Pflege der Oberflächendateien und die benötigte Art der API-Referenz.

Geprüft am **10. November 2026** anhand der veröffentlichten Versionen **Ardo 6.5.0**, **Nimbus 0.19.4** und **Nimbus-Scaffolder 0.8.3**. Die folgenden Nimbus-Quellen sind auf den [Release-Commit von 0.19.4](https://github.com/cloudflare/nimbus/tree/980cee6da75f81982552b68a3607c0a19ee11987) festgelegt und verwenden kein unveröffentlichtes main. Ardo basiert auf dem [Tag 6.5.0](https://github.com/sebastian-software/ardo/tree/ardo-v6.5.0).

## Welcher Ablauf passt? {#which-workflow-fits}

Wähle Ardo, wenn Dokumentation und Beispiele dasselbe React-Komponentenmodell verwenden sollen, die API aus TypeScript stammt und du die UI als Paket aktualisieren möchtest. Eigene React-Root-Komponenten und Layouts bleiben möglich.

Wähle Nimbus, wenn die direkte Pflege der Layout-, Komponenten- und Stildateien für deinen Ablauf wichtig ist oder du die umfangreichere OpenAPI-Referenz und optionale serverseitige Agent-Dienste benötigst. Seine [Projektstruktur](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/project-structure.mdx) trennt eigene Dateien von der Framework-Abhängigkeit; Updates überschreiben die Website nicht einfach.

## Funktionsvergleich {#feature-comparison}

| Bereich | Ardo 6.5.0 | Nimbus 0.19.4 |
| --- | --- | --- |
| Seitenmodell | React-Seiten und MDX, vorgerendert und hydriert; normale Dokumentnavigation. | Astro-Seiten und MDX. Interaktive Framework-Komponenten verwenden [Astro Islands](https://docs.astro.build/en/concepts/islands/). |
| UI-Zuständigkeit | Die UI wird im Paket geliefert; mit React kombinierbar oder ersetzbar. | Generierte Layouts, Komponenten und Stile liegen in [deinem Repository](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/project-structure.mdx). |
| API-Referenz | Native TypeScript-Referenz und statischer Generator für lokale OpenAPI-Dateien. | [OpenAPI 3.x](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/api-reference/index.mdx) mit eigenen Operationen, Schemas, API-Versionen und Referenzoberfläche. |
| Sprachen | Vollständige statische Sprachbäume; die vier Sprachen dieser Website verwenden Palamedes-Kataloge. | Nimbus stellt eine Dokumentensprache für die Website bereit; Sprachrouting und Übersetzung liegen beim [Astro-Projekt](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/packages/nimbus-docs/src/types.ts). |
| Versionierung | Statische Snapshots großer Versionen; Guide-/API-Verzeichnisse lassen sich unabhängig von Website-Seiten versionieren. | Getrennte Inhaltssammlungen und Pfade für [ältere Dokumentationsversionen](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/navigation/versioning.mdx); API-Versionen besitzen ein eigenes Modell. |
| Suche | Integriertes MiniSearch mit generierten Indizes. | Statische [Pagefind-Suche](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/navigation/search.mdx) oder ein eigener Anbieter des Projekts. |
| Dateien für Agenten | Markdown pro Seite, llms.txt, llms-full.txt und optionale Agent-Skills-Erkennung. | [Markdown und llms.txt](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/ai/publish-markdown.mdx), mit optionalen Agent-Diensten. |
| MCP | Kein vom Framework bereitgestellter MCP-Endpunkt zur Laufzeit. | Optionales [Remote-MCP](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/ai/remote-mcp.mdx): list\_pages und get\_page; benötigt Serveradapter und SDK. |
| Prüfung und Linting | ardo check ohne Build, ardo lint für Inhalte und Prüfung interner Links beim Build. | [nimbus-docs check und lint](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/cli.mdx), einschließlich Korrekturen und Upgrade-Prüfungen. |
| Rezepte | ardo add gibt zur Version passende Rezepte aus und schreibt keine Dateien. | [add](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/cli.mdx) kopiert Komponentenquellcode; Funktionen liefern einem Agenten Rezepte. |
| JavaScript im Browser | React-Hydration und interaktive UI; kein Client-Router. | Astro Islands mit den gewählten Komponenten und Skripten; die übertragene Datenmenge hängt von dieser Zusammenstellung ab. |
| Hosting | Statische Dateien auf jedem statischen Host. | [Standardmäßig statisch](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/deploy/other-hosts.mdx); Rendering bei Anfragen und Remote-MCP benötigen einen Serveradapter. |

Ardos [API-Leitfaden](<https://ardo-docs.dev/v6/de/guide/api-documentation/>), [Konfiguration](<https://ardo-docs.dev/v6/de/guide/configuration/>), [Internationalisierung](<https://ardo-docs.dev/v6/de/guide/internationalization/>) und [Agent-Anleitung](<https://ardo-docs.dev/v6/de/guide/agent-instructions/>) erläutern die Ardo-Seite dieser Tabelle. Nimbus hat Version 1.0 noch nicht erreicht; prüfe die Versionshinweise, bevor du bei einer späteren Minor-Version identisches Verhalten voraussetzt.

## Umstieg von Nimbus {#coming-from-nimbus}

| Nimbus-Projekt | Ardo-Entsprechung oder Migrationsaufwand |
| --- | --- |
| src/content/docs/ | Verschiebe Inhalte nach app/routes/, bei entsprechender Konfiguration mit Sprach- und guide-Verzeichnissen. Erhalte alte URLs durch ausdrückliche Weiterleitungen. |
| title, description, sidebar.order | Behalte title und description; übertrage sidebar.order nach order. Prüfe andere [Frontmatter](<https://ardo-docs.dev/v6/de/guide/frontmatter/>)-Felder einzeln. |
| mode: custom | Verwende layout: bare für eine Seite ohne Dokumentationsrahmen. |
| src/components.ts und Astro-Komponenten | Prüfe jede Komponente und ihre Props; portiere Astro-Code nach React oder nutze Ardos MDX-Komponenten. Eine automatische Komponentenkonvertierung gibt es nicht. |
| astro.config.ts und nimbus() | Verwende ardo.config.ts für Framework-Optionen und eigene Vite-Plugins, app/root.tsx für den UI-Aufbau. |
| OpenAPI-Referenzen | Beginne mit Ardos lokaler openapi-Konfiguration. Nimbus-API-Versionen, Schemaansichten und interaktive Referenzfunktionen lassen sich nicht direkt übertragen. |

Prüfe vor dem Umzug Entwürfe, verborgene Seiten und Veröffentlichungsregeln; Nimbus-Schalter behalten in Ardo nicht automatisch ihre Bedeutung. Folge der [Einrichtungsanleitung](<https://ardo-docs.dev/v6/de/guide/agent-instructions/>) und prüfe veröffentlichte Routen, Links und Beispiele in einer Produktionsvorschau.

## Lücken und laufende Arbeiten {#gaps-and-current-work}

Nimbus unterstützt außerdem [Git-Inhaltsquellen](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/content-sources/git.mdx) und [Teil-Builds](https://github.com/cloudflare/nimbus/blob/980cee6da75f81982552b68a3607c0a19ee11987/apps/www/src/content/docs/publish/partial-builds.mdx). Die entsprechenden Ardo-Vorschläge bleiben [#473](https://github.com/sebastian-software/ardo/issues/473) und [#474](https://github.com/sebastian-software/ardo/issues/474). Ein Checkout in CI mit anschließender lokaler Inhaltszuordnung ist bereits heute möglich.

Ardos Inhaltskomponenten, check/lint-Befehle, statisches Mermaid-Rendering und Rezepte sind bereits implementiert: [#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) und [#475](https://github.com/sebastian-software/ardo/issues/475). Automatische Vorschaubilder für Seiten werden in [#471](https://github.com/sebastian-software/ardo/issues/471) verfolgt; sie gehören nicht zur hier verwendeten veröffentlichten Version 6.5.0.
