Paket-Architektur
Das Blog- und Changelog-System wird als @nextsaasai/blog-Paket mit einer dualen Export-Struktur ausgeliefert. Server-seitige Operationen — Dateisystem-Lesezugriffe, MDX-Kompilierung, Frontmatter-Parsing — werden aus @nextsaasai/blog exportiert. Client-seitige React-Komponenten — Timeline-Layouts, Suche, Inhaltsverzeichnis — werden aus @nextsaasai/blog/client exportiert. Diese Trennung hält server-exklusive Abhängigkeiten (Node.js fs, MDX-Compiler) vollständig aus den Client-Bundles heraus.
Content-Dateien nutzen MDX mit YAML-Frontmatter, das zur Build-Zeit durch Zod-Schemas validiert wird. Ungültige oder fehlende Felder erzeugen klare Fehlermeldungen statt stiller Rendering-Fehler. Syntax-Highlighting läuft über Shiki mit Dual-Theme-Unterstützung — separate Themes für Light- und Dark-Mode, ohne Laufzeit-Overhead durch Theme-Wechsel.
Blog-Features
Blog-Posts sind über Dateisystem-Verzeichnisse organisiert, die direkt auf Navigations-Kategorien abgebildet werden. Jede Kategorie erhält eine eigene gefilterte Ansicht und einen RSS-2.0-Feed. Detailseiten enthalten ein Social-Sharing-Dropdown mit Unterstützung für X/Twitter, LinkedIn, Facebook, WhatsApp, E-Mail und Clipboard-Kopieren — plus native Share-API-Integration auf unterstützten Geräten.
Changelog-Features
Der Changelog verwendet ein vertikales Timeline-Layout. Einträge rendern ihren vollständigen Inhalt direkt auf der Listenansicht — kein Klick erforderlich, um ein Update zu lesen. Jeder Eintrag trägt eine Versionsnummer und ein Datum. Eine quick-Variante existiert für kleinere Updates, die nur einen Absatz oder zwei benötigen, während die full-Variante Überschriften, Code-Blöcke und einklappbare <Details>-Sektionen für längere Release Notes unterstützt. Contributor-Avatare erscheinen bei jedem Eintrag und verknüpfen Updates mit den Team-Mitgliedern, die sie umgesetzt haben.
Contributors
Sascha Rahn