hadihz.me
Diese Website, die Sie gerade besuchen, konzentriert sich auf Ästhetik, Visuals und Leistung mit minimalem JavaScript-Fußabdruck, gebaut mit Astro 7, unterstützt von Strapi 5!


Architekturüberblick
Das ist die Website, die Sie gerade lesen: ein Portfolio in vier Sprachen (Englisch, Arabisch, Französisch und Deutsch, auf Arabisch von rechts nach links), gebaut mit Astro und gespeist von einem Strapi-CMS. Sie soll gut aussehen und schnell laden, deshalb ist jede Seite vorgerendertes HTML aus einem CDN, mit JavaScript nur dort, wo eine Interaktion es braucht.
Die Website dokumentiert sich außerdem selbst. Diese Website
zeigt den Dateibaum des Repositorys, beim Build aus git ls-files erzeugt, mit
Notizen zu den wichtigen Pfaden, die im CMS in allen vier Sprachen geschrieben
sind. Diese Seite ist die kürzere Tour.
Statisch aus Prinzip
Die Astro-Konfiguration setzt keinen Adapter, und diese eine Auslassung prägt alles andere. Zur Anfragezeit gibt es keinen Server, also passiert jedes Lesen beim Build, in einer Sync-Phase, die einmal läuft, bevor irgendeine Seite gerendert wird.
- Inhaltsänderungen brauchen einen neuen Build, deshalb hat das CMS einen Deploy-Button: ein kleines Strapi-Plugin, das das Website-Deployment startet und seine Läufe im Admin anzeigt.
- Secrets erreichen nie den Browser, weil der Build der einzige Prozess ist, der sie hält. Das CMS-Token ist eine reine Server-Umgebungsvariable von Astro.
- Zwei Ausnahmen, beide ohne Secrets. Das Kontaktformular schreibt ins CMS und schützt sich mit einem Honeypot und einem Rate-Limit statt mit einem Token, und es antwortet Besuchern per E-Mail in der Sprache, in der sie geschrieben haben. Die optionale Anmeldung, per E-Mail und Passwort oder mit GitHub, hält ihre Zugangsdaten in einem httpOnly-Cookie auf der CMS-Domain und ihr kurzlebiges Access-Token im Speicher, nie in einem Storage.
- Gemessen, nicht vermutet. Der Dark Mode zeigte gemessene 532 ms lang die
helle Palette, bevor eine Klasse griff; heute ist er eine
prefers-color-scheme-Media-Query, die vor dem ersten Paint aufgelöst wird, was Code gelöscht statt hinzugefügt hat.
Im Inneren der Web-App
apps/web/src besteht aus vier Schichten, und entscheidend ist die Richtung
zwischen ihnen.
- Dateinamen sind Rollen. In einem Feature ist
repository.tsdie Abrufschicht, die ein Content-Loader aufruft, undservice.tsliest das Ergebnis aus dem Content Store zurück; ein Feature erreicht ein anderes nur über dessenservice.ts. Eine Datei, die schwer zu benennen ist, tut meist zwei Dinge. - Keine Barrels, mit Absicht. Ein Test folgt jedem statischen und
dynamischen Import von jedem Browser-Einstiegspunkt aus und schlägt fehl,
wenn einer
astro:contentoder eine reine Servervariable erreicht, sodass nie ein Servermodul in ein Bundle rutscht. - Vier Sprachen, ein Seitenverzeichnis. Eine im Repository geschriebene
Astro-Integration durchläuft
src/pages/und fügt für jede Sprache außer Englisch eine/{locale}-Route ein, mit übersetzten Slugs aus einem einzigen Manifest, das auch Paraglides URL-Muster speist. Englisch bleibt ohne Präfix, und ein Link auf eine umbenannte Seite ist ein Kompilierfehler. - Die Suche ist eine statische Datei pro Sprache, beim Build aus Projekten, Beiträgen, Einträgen des Lebenslaufs und Tags zusammengesetzt. Auch die Open-Graph-Bilder werden pro Seite beim Build gerendert.
Das CMS
Strapi 5 läuft als eigene App auf einem eigenen React-Stack und teilt mit der Website nichts außer Daten.
- Ein generierter Vertrag.
pnpm --filter admin generateliest das Schema aus einem laufenden Strapi und schreibt einen typisierten Client in die Web-App. Inhaltstyp ändern, neu generieren, und die Typfehler sagen, was zu reparieren ist. - Für vier Sprachen gebaut.
strapi-plugin-ai-translate, ein Paket in diesem Repository, übersetzt einen Eintrag aus der Bearbeitungsansicht mit einem LLM in die anderen Sprachen; Prompt und Modell werden im Admin eingestellt. Seine zehn E-Mail-Vorlagen, darunter die Antworten auf das Kontaktformular, sind von Hand geschrieben. - Inhalte, die die Website tragen: Projekte, Beiträge, der Lebenslauf aus Berufserfahrung und Ausbildung, Empfehlungen, GitHub-Beitragsdaten und die Dateinotizen hinter der selbstdokumentierenden Seite.
CI/CD
Änderungen landen per Pull Request auf dev, und ein Pull Request von dev
nach master liefert sie aus. Prüfungen und Deployments sind getrennte
Workflows, und diese eine Trennung hält beide einfach.
Vom Branch bis zum CDN
Der Lebenslauf eines Pull Requests
- Ein einziger Prüf-Job, mit Absicht. Früher waren es drei Jobs plus ein
Sammel-Gate, und jeder bezahlte eine vollständige Installation von Astro und
Strapi. Ein Job bezahlt sie einmal, während Turborepo darin trotzdem Lint,
Typprüfung und Tests nebeneinander laufen lässt, mit
--continue, damit jeder Fehler in einem Lauf sichtbar wird. - Prettier läuft zuerst, und die Reihenfolge zählt. Es liest nur seine eigene Ignore-Datei, muss also laufen, bevor irgendetwas generierte Dateien in den Arbeitsbaum schreibt.
- Bei jedem Pull Request wird die ganze Website gebaut, weil die Typprüfung nie eine Seite rendert: Eine Komponente, die an einem fehlenden CMS-Feld scheitert, besteht die Prüfung und bricht den Build. Das CMS wird dort nicht gebaut, weil das jedem Pull Request seine Produktions-Secrets geben würde.
- Die CI läuft nur auf Pull Requests. Ein Pull Request wird auf seinem
Merge mit der Basis geprüft, also ist der Baum, der auf
masterlandet, der bereits geprüfte; der Branch-Schutz verhindert, dass sich die Basis darunter bewegt. - Das Web-Deployment wird nie gefiltert. Die selbstdokumentierende Seite wird aus jeder versionierten Datei des Repositorys gebaut, also ändert selbst ein Commit, der nur die Doku berührt, eine veröffentlichte Seite. Das CMS-Deployment, ein 1-GB-Image und ein Neustart, läuft nur, wenn sich seine Pfade ändern.
- Caching auf drei Ebenen: der pnpm-Store, Turborepos Remote-Cache mit signierten Artefakten und Astros Build-Cache. Renovate öffnet ein Update erst, wenn ein Release eine Woche alt ist.
Auslieferung
- Das CMS wird als Container ausgeliefert, auf einen VPS, mit einem Schlüssel, der nur das Deploy-Skript ausführen kann, neben seiner eigenen PostgreSQL-Datenbank, die jede Nacht gesichert wird. Ein gescheiterter Health-Check holt das vorherige Image zurück.
- Die Website wird nach dem CMS ausgerollt, damit ein Build nie ein Schema liest, das das CMS noch nicht ausliefert. Sie lädt die gehashten Assets vor dem HTML hoch, das auf sie verweist, invalidiert CloudFront und schlägt fehl, wenn die Website nicht binnen 40 Sekunden antwortet.
Mit KI-Agenten gebaut
Das Repository ist für Coding-Agenten ebenso eingerichtet wie für Menschen.
- Doku, die den Weg weist. Ein kurzes
AGENTS.mdim Root verweist auf einen Leitfaden pro App und auf sechs für dieses Repository geschriebene Skills:feature-modules(wohin Code gehört),client-controllers(Verhalten im Browser),design-system,output-neutral-refactor(Refactorings, die das gerenderte HTML nicht ändern dürfen),cms-annotations(die Dateinotizen mit dem Baum in Einklang halten) unddraft-content. - Inhalte von einem Agenten entworfen, von einem Menschen veröffentlicht.
draft-contentrecherchiert ein Repository oder ein Thema, entwirft eine Projektseite oder einen Blogbeitrag in vier Sprachen und speichert sie über Strapis eingebauten MCP-Endpunkt als unveröffentlichte Entwürfe im CMS; diese Seite ist so entstanden und wurde vor der Veröffentlichung geprüft. - Design- und Motion-Skills. Sechzehn Skills von Emil Kowalski zu Animation, Interaktion und Feinschliff sind in einer Lock-Datei fixiert.
Hauptfunktionen:
- Vier Sprachen mit übersetzten URLs, auf Arabisch von rechts nach links, Englisch ohne Präfix
- Vorgerenderte Seiten auf S3 und CloudFront, mit JavaScript nur in Islands, die es brauchen
- View Transitions, ein Dark Mode ohne Aufblitzen und ein Globus der Orte, an denen Projekte entstanden
- Eine selbstdokumentierende Seite: der echte Repository-Baum mit Notizen aus dem CMS
- Statische Suche und Open-Graph-Bilder pro Seite, beides beim Build erzeugt
- Ein Kontaktformular, das in der Sprache der Besucher antwortet, und eine optionale Anmeldung per E-Mail oder GitHub
- Ein Strapi-Admin mit KI-Übersetzung und einem Deploy-Button, der die Website neu baut
Tech-Stack:
- Web: Astro 7, React 19, Tailwind v4, Paraglide, TypeScript, Embla, Mermaid, Shiki
- CMS: Strapi 5, PostgreSQL, Resend, OpenRouter für Übersetzungen
- Infrastruktur: AWS S3 und CloudFront, Docker auf einem VPS, nächtliche Backups nach Cloudflare R2
- Tooling: Turborepo, pnpm, ESLint, Prettier, Vitest, Renovate, GitHub Actions
In Zahlen (November 2026): rund 980 Commits seit April 2026, 151 gemergte Pull Requests, 61 Testdateien, 15 Feature-Module, 19 Inhaltstypen und 5 GitHub-Actions-Workflows.