1.7.2026 · Atylus
Migration zu Astro und Starlight ohne Design- oder SEO-Verlust
Eine Zusammenfassung der strukturellen und SEO-relevanten Entscheidungen beim Umzug eines SCSS-lastigen Next.js-Projekts zu Astro und Starlight.
Problemstellung
Ein Framework-Wechsel ohne Veraenderung des Designs bringt meist zwei Risiken mit:
- Die CSS-Kaskade kann brechen.
- SEO-Signale koennen beim Neuaufbau der crawlbaren Informationsarchitektur geschwaecht werden.
Eingesetzte Strategie
- Die globale SCSS-Schicht wurde unveraendert uebernommen.
- Bestehende Layout-Klassennamen wurden wiederverwendet.
- Die Dokumentation wurde nach Starlight verschoben.
- Der Blog wurde mit Astro Content Collections typsicher modelliert.
Erwartete Vorteile
- Geringere clientseitige JavaScript-Kosten
- Klarere Informationsarchitektur fuer die Dokumentation
- Bessere statische HTML-Ausgabe
- Einfachere Sitemap- und Search-Integration
