hadihz.me
PersönlichSchwer

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!

— Überblick

Architekturüberblick

AWS

apps/admin · Strapi 5

apps/web · Astro 7, statisch gebaut

generierter Client

vorgerendertes HTML

Medien

Kontaktformular, Anmeldung

Content-Loader
Sync-Phase, vier Sprachen

Astro Content Store

Seiten + React-19-Islands

REST-API + typisierter Client

PostgreSQL

S3

CloudFront

Besucher

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.

S3 + CloudFrontContent StoreStrapiGenerierter ClientAstro-BuildContent-Loader laufen einmalJede Collection holen, vier SprachenTypisierte DokumenteValidieren und speichernSeiten lesen den Store, nie StrapiDas vorgerenderte HTML hochladen
  • 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.

features/
15 Domänenmodule: Projekte, Blog, Über mich, Kontakt, Suche...

shell/
Header, Footer, SEO, Analytics

design-system/
Primitives + Patterns, ohne Domänenwissen

core/
Controller, Strapi-Client, Loader

  • Dateinamen sind Rollen. In einem Feature ist repository.ts die Abrufschicht, die ein Content-Loader aufruft, und service.ts liest das Ergebnis aus dem Content Store zurück; ein Feature erreicht ein anderes nur über dessen service.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:content oder 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.

apps/admin

Deploy-Button

19 Inhaltstypen
Projekte, Blog, Lebenslauf, Dateinotizen...

Plugins
KI-Übersetzung, Web-Deployment, Email Designer

pnpm generate
typisierter Client

apps/web

GitHub Actions

  • Ein generierter Vertrag. pnpm --filter admin generate liest 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

Admin geändert

Feature-Branch

PR nach dev

Checks

dev

PR nach master

Checks

master

Deploy-Workflow

CMS-Deployment

Web-Deployment

Der Lebenslauf eines Pull Requests

S3 + CloudFrontDeploy-WorkflowTurborepo-CacheChecks-JobGitHubEntwicklerPR öffnen1Lauf auf dem Merge-Commit2Repo-Baum aktuell, Prettier3Lint, Typen, Tests, Bestandenes abspielen4Die ganze Website bauen5Eine Pflichtprüfung6Mergen, dann dev nach master bringen7Push auf master8Build synchronisieren, Cache invalidieren9Die Website antwortet mit 20010
  • 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 master landet, 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

Web-Deployment

CMS-Deployment

scheitert

Strapi-Image bauen

Per SSH an einen
erzwungenen Befehl

Container neu erstellen

Health-Check

Vorheriges Image zurück

astro build

Sync nach S3
gehashte Assets zuerst

CloudFront invalidieren

200 binnen 40 s?

  • 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.md im 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) und draft-content.
  • Inhalte von einem Agenten entworfen, von einem Menschen veröffentlicht. draft-content recherchiert 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.

— Stack
AstroStrapiDevOpsTurborepo