Wo der MZP noch Mehrwert holen kann — Design- & Publishing-Audit

Executive Summary

Fuenf Kernthesen, bevor der Report in die Tiefe geht.

These 1

mzone-ui 1.3.0 ist im visuellen und interaktiven Bereich — Canvas-VFX, WebGL, 3D, Scroll-Choreografie — bereits vor der Konkurrenz. Kein Docs-Tool am Markt bietet vergleichbare Effekt-Tiefe out of the box.

These 2

Bei den unspektakulaeren, aber unverzichtbaren Publishing-Grundfunktionen — sitegreifende Suche, Versionsvergleich, Feeds, Social-Previews — liegt der MZP hinter Docusaurus, Mintlify und GitBook zurueck. Diese Luecke ist strukturell, nicht kosmetisch.

These 3

Der bewusste Verzicht auf Syntax-Highlighting und externe Abhaengigkeiten ist eine valide Architekturentscheidung, kein Versehen — sollte aber sichtbar dokumentiert bleiben, damit sie nicht als Luecke missverstanden wird.

These 4

Bento-Grid und Glassmorphismus sind 2026 vom Trend zum Standard geworden. mz-grid deckt das Umbruchverhalten ab, es fehlt aber eine Variante fuer variabel grosse Kacheln.

These 5

Die groesste ungenutzte Chance liegt bereits im Haus: fullTextSearch existiert serverseitig im MCP-Server. Es fehlt nur die oeffentliche Such-Oberflaeche auf den publizierten Seiten selbst.

CSS-Klassen

in 14 Gruppen, mzone-ui 1.3.0

Modul-Exporte

in 11 fx-Gruppen

365 KB

Katalog-Groesse

33 Dateien, gepinnt

140+

publizierte Seiten

aktueller MZP-Bestand

Methodik

Recherchiert wurde in zwei Richtungen. Extern per Websuche gegen Vergleichsartikel und Trendberichte von 2026 (Docusaurus/Mintlify/GitBook-Vergleiche, UI/UX-Trendlisten, die Algolia-DocSearch/AskAI-Ankuendigungen). Intern durch vollstaendigen Abgleich gegen den mzone-ui-1.3.0-Katalog ueber getCapabilities und lookupStyles — jede Klasse und jedes fx-Modul wurde einzeln nachgeschlagen, nicht geraten. Ergaenzend wurden bestehende interne Audits gesichtet (u.a. die Canvas-UI-Paritaets- und Feature-Audit-Seiten des MZP selbst), um Redundanzen zu vermeiden und nur Luecken zu benennen, die dort noch nicht geschlossen sind.

Marktvergleich 2026

Wo steht Docs- und Report-Publishing gerade, und was hat sich als Designtrend durchgesetzt?

Docusaurus bleibt 2026 die Wahl fuer Teams mit eigener React-Infrastruktur: volle Gestaltungsfreiheit, aber auch volle Wartungslast. Mintlify hat sich als verwaltete Alternative etabliert — production-ready Design, eingebaute Suche, API-Playgrounds und eine native KI-Assistenz, dafuer eine sichtbare Gestaltungsobergrenze. GitBook gewinnt bei gemischten Teams: ein block-basierter Editor, den auch Nicht-Entwickler bedienen koennen, ohne je eine Code-Datei zu oeffnen. Storybook bleibt Komponentenbibliothek, kein Report-Werkzeug, und faellt fuer den direkten Vergleich damit grossteils raus.

Auf der Design-Seite ist der Bento-Grid-Stil vom Apple-inspirierten Kniff zum Standard fuer dichte, mehrgeraetetaugliche Oberflaechen geworden — mit staerker abgerundeten Ecken und Mikro-Interaktionen pro Kachel. Glassmorphismus hat sich von reinem Stilexperiment zu einem funktionalen Werkzeug fuer visuelle Hierarchie weiterentwickelt, besonders bei Dashboards. Parallel dazu treiben variable Schriftschnitte fluide Typografie: Text reagiert nicht mehr nur auf Breakpoints, sondern auf Viewport, Interaktion und Nutzerpraeferenz zugleich. Und als Gegenbewegung zum durchgestylten Bento-Look taucht 2026 vermehrt Anti-Grid-Brutalismus auf — bewusst kantig, als Kontrast zur Glattheit.

Plattform	Hosting	Design-Freiheit	Interaktive Effekte	Suche	Versionierung	Zielgruppe
Docusaurus	Self-hosted (React)	Hoch	Gering (Eigenbau noetig)	Algolia DocSearch als Plugin	Git-basiert, manuell	Engineering-Teams mit eigener Infra
Mintlify	Managed	Mittel (Theme-Grenzen)	Gering	AskAI eingebaut	Eingebaut	Engineering-Teams ohne Infra-Aufwand
GitBook	Managed	Niedrig (Block-Editor)	Keine	Basis-Suche	Eingebaut	Gemischte Teams, non-technical Autoren
Storybook	Self-hosted	Hoch (Komponentenfokus)	Keine	Lokale Component-Suche	Addon-basiert	Komponentenbibliotheken
MZP · mzone-ui 1.3.0	Self-hosted (MCP)	Sehr hoch	Sehr hoch (Canvas/WebGL/3D)	Serverseitig vorhanden, keine oeffentliche UI	Versioniert, kein Diff	Agenten-getriebene Reports & Artefakte

Interaktive Effekte Publishing-Grundfunktionen

mzone-ui 1.3.0 im Bestand

Der aktuelle Katalog umfasst 73 CSS-Klassen in 14 Gruppen — von Geruest und Typografie ueber Karten, Daten, Status und Bedienelemente bis zu einem eigenen Report-Vokabular fuer Zeitleisten, Legenden, Key/Value-Paare und Accordions. Dazu kommen 33 fx-Modul-Exporte in 11 Gruppen: Hintergrund-Effekte (Partikelfeld, Pulsraster, Wabenraster, Glyphenregen, WebGL-Hero), Interaktion (Ripple, Magnify, Confetti, Shatter, VHS), Optik (Frost, Bend, Peel), Energie (Flame, ForceField, Laser), Text-Effekte (Decrypt, Glitch, ParticleReveal), Scroll-Choreografie sowie ein eigener GLB-3D-Renderer ohne Abhaengigkeit von three.js-Addons.

Bemerkenswert ist die durchgaengige Barrierefreiheits-Disziplin: jedes Modul liest prefers-reduced-motion live und reagiert waehrend der laufenden Sitzung, jeder dekorative Canvas traegt aria-hidden, verrauschter oder animierter Text liegt zusaetzlich als sr-only im DOM, und interaktive Komponenten wie Tabs, Accordion und Filter-Tabelle funktionieren als progressive Enhancement — ohne JavaScript bleibt die Seite vollstaendig lesbar. Das ist mehr Sorgfalt, als die meisten kommerziellen Docs-Plattformen in ihre Effekt-Schicht investieren, schlicht weil die meisten gar keine Effekt-Schicht haben.

Die Roadmap ist bereits sichtbar angelegt: domTexture steht seit 1.3.0 als Fundament bereit, aber noch ohne Verbraucher — die ersten Abnehmer (ASCII-Effekt, Dither, Displace, Clouds) sind fuer 1.4.0 angekuendigt. Das zeigt, dass das Design-System aktiv weitergebaut wird und Luecken wie die unten beschriebenen kein Zeichen von Stillstand sind, sondern von Reihenfolge.

Gap-Analyse

Drei Bereiche, je mit konkretem Befund.

Content-Struktur & Wiki-Engine

G1Luecke
Keine sitegreifende Such-Oberflaeche: fullTextSearch existiert im MCP-Server, aber es gibt keine oeffentliche UI dafuer auf den publizierten Seiten selbst.
G2Luecke
Kein automatisches Inhaltsverzeichnis: mz-nav existiert, aber die Anker werden von Hand gepflegt statt aus Ueberschriften generiert.
G3Einschraenkung
Kein Versions-Diff: listVersions liefert die Historie, aber keine visuelle Gegenueberstellung zweier Versionen.
G4Luecke
Kein RSS/Atom-Feed und kein sitemap.xml fuer den Gesamtbestand von aktuell ueber 140 publizierten Seiten.
G5Einschraenkung
Keine automatische Social-Preview: metadataJson traegt Titel, Beschreibung und Tags, aber kein Vorschaubild.

Design-System (mzone-ui)

G6Einschraenkung
Kein Bento-/Masonry-Raster mit variabler Kachelgroesse: mz-grid ist regelmaessig (--2/--4), es fehlt ein Span-System fuer breite oder hohe Kacheln.
G7Einschraenkung
Keine fluiden Typografie-Tokens: --mz-font ist ein Font-Stack, keine an den Viewport gekoppelte Groessenskala.
G8Bewusste Grenze
Kein Syntax-Highlighting — explizit so entschieden, um keinen Tokenizer als Fremdabhaengigkeit einzufuehren. Kein Versehen, sollte aber im Katalog als bewusste Grenze markiert bleiben.
G9Einschraenkung
Kein Feedback-Baustein nach dem Muster "War das hilfreich?".
G10Einschraenkung
Keine sichtbare Page-View-Anzeige auf der Seite selbst, obwohl getPageStats die Daten serverseitig bereits liefert.

Performance & Technik

G11Einschraenkung
Kein dokumentiertes Lazy-Loading-Muster fuer schwere WebGL-Module (object3d, frost, ripple im WebGL-Modus) — sie werden vermutlich beim Seitenaufruf sofort geladen.
G12Einschraenkung
three.js (1,3 MB) und chart.js (205 KB) sind gepinnt, aber es gibt keine Warnung im Publish-Flow, wenn ein Artefakt mehrere schwere Bibliotheken gleichzeitig einbindet.
G13Ungenutztes Potenzial
Die versionierten /lib/-Pfade erlauben eigentlich triviales Langzeit-Browser-Caching ueber Artefakt-Versionen hinweg — das ist vorhanden, aber nirgends explizit dokumentiert oder beworben.

Konkrete Verbesserungsvorschlaege

Priorisiert nach Aufwand — Quick Wins, Mittelfrist, Strategisch. Auswahl ueber die Reiter.

P0 · Quick Wins P1 · Mittelfristig P2 · Strategisch

Sitegreifende Such-UI: ein leichtes Client-Widget, das gegen einen woechentlich aus fullTextSearch exportierten Index sucht — kein Server-Roundtrip noetig, passt zur No-Dependency-Policy.
Auto-TOC-Generator: ein Snippet, das beim Publish aus h2/h3 automatisch mz-nav befuellt statt es von Hand zu pflegen.
RSS/Atom-Feed: ein Endpoint, generiert direkt aus listPublishedPages, ohne neues Datenmodell.
sitemap.xml: ebenfalls aus listPublishedPages ableitbar, gleicher Aufwand wie der Feed.
Feedback-Pill: das "War das hilfreich?"-Muster als Rezept im Katalog dokumentieren — zwei Buttons plus Zaehler, optional an getPageStats angebunden.

Bento-Grid-Variante: mz-grid--bento mit Span-Klassen fuer breite und hohe Kacheln — reiner CSS-Zusatz, keine neue Abhaengigkeit.
Fluide Typografie-Skala: Tokens wie --mz-text-sm/base/lg/xl auf clamp()-Basis, ergaenzend zu --mz-font.
Sichtbarer Page-View-Zaehler: ein kleiner mz-stat, gespeist aus getPageStats, optional mit scrollFx.counter() hochgezaehlt.
Automatische "Verwandte Seiten": eine Leiste unterhalb von mz-crossrefs, gespeist aus searchPages statt Handarbeit.
Versions-Diff-Ansicht: zwei Versionen aus listVersions nebeneinander, Textdiff auf HTML-Ebene reicht.

KI-Such-/Frage-Schicht: fullTextSearch plus LLM-Zusammenfassung — analog zu Algolia AskAI, aber MCP-nativ und ohne externen SaaS-Vertrag.
API-/MCP-Playground: interaktive Anfrage-Konstruktion direkt auf publizierten Service-Seiten, um MCP-Tools live auszuprobieren.
Design-Tokens-Export: die vorhandenen CSS-Custom-Properties als JSON im Figma-Tokens-Format — macht mzone-ui auch ausserhalb des MZP nutzbar.
Kommentar-/Annotationsschicht: leichtgewichtig und MCP-gestuetzt statt eines Drittanbieter-Widgets.

Roadmap-Vorschlag

2026 Q3 — jetzt
P0-Quick-Wins umsetzen, wie in diesem Report dokumentiert.
2026 Q4 · mzone-ui 1.4.0
Bereits angekuendigte domTexture-Verbraucher (ASCII, Dither, Displace, Clouds) plus die P1-Punkte Bento-Grid und fluide Typografie.
2027 Q1
Verwandte-Seiten-Leiste und Versions-Diff aus P1; erste P2-Bausteine als Prototyp.
2027 Q2
KI-Suche und MCP-Playground aus P2, abhaengig von verfuegbarer Server-Kapazitaet.

Warum diese Reihenfolge?

Quick Wins zuerst, weil sie auf bereits vorhandenen Server-Faehigkeiten (fullTextSearch, listPublishedPages, getPageStats) aufbauen und nur eine UI-Schicht fehlt. Die P1-Punkte sind reine CSS/Token-Erweiterungen ohne neue Abhaengigkeit. P2 ist bewusst zuletzt eingeordnet, weil KI-Suche und Playground echte Kapazitaetsfragen an den MCP-Server stellen, nicht nur Design-Entscheidungen.

Fazit

Der MZP muss sich im Design nicht verstecken — im Gegenteil, mzone-ui 1.3.0 spielt in der Effekt-Tiefe in einer eigenen Liga. Der Mehrwert, der noch zu holen ist, liegt nicht in mehr Glanz, sondern in den leisen Publishing-Grundfunktionen, die Docusaurus, Mintlify und GitBook selbstverstaendlich mitbringen: Suche, Feeds, Versionsvergleich, Social-Previews. Die gute Nachricht: fuer die meisten dieser Luecken existiert die Datenbasis serverseitig bereits — es fehlt nur die letzte, sichtbare Schicht.