hadihz.me
PersonnelDifficile

hadihz.me

Ce site web que vous visitez en ce moment même, axé sur l'esthétique, le visuel et la performance, avec une empreinte JavaScript minimale, construit avec Astro 7, propulsé par Strapi 5 !

— Vue d'ensemble

Aperçu de l'architecture

AWS

apps/admin · Strapi 5

apps/web · Astro 7, généré statiquement

client généré

HTML prérendu

médias

formulaire de contact, connexion

Loaders de contenu
phase de synchro, quatre langues

Content store d'Astro

Pages + îlots React 19

API REST + client typé

PostgreSQL

S3

CloudFront

Visiteur

C'est le site que vous êtes en train de lire : un portfolio en quatre langues (anglais, arabe, français et allemand, de droite à gauche en arabe) construit avec Astro et alimenté par un CMS Strapi. Il doit être beau et se charger vite : chaque page est donc du HTML prérendu servi par un CDN, avec du JavaScript seulement là où une interaction en a besoin.

Le site se documente aussi lui-même. Ce site montre l'arborescence du dépôt, générée depuis git ls-files au moment du build, avec des notes sur les chemins qui comptent, rédigées dans le CMS en quatre langues. Cette page en est la version courte.

Statique par construction

La configuration d'Astro ne déclare aucun adaptateur, et cette seule omission façonne tout le reste. Il n'y a pas de serveur au moment de la requête : toute lecture a donc lieu au build, dans une phase de synchronisation qui s'exécute une fois, avant le rendu de la moindre page.

S3 + CloudFrontContent storeStrapiClient généréBuild AstroLes loaders de contenu tournent une foisRécupère chaque collection, quatre languesDocuments typésValide et stockeLes pages lisent le store, jamais StrapiEnvoie le HTML prérendu
  • Une modification de contenu demande un nouveau build, d'où le bouton Deploy du CMS : un petit plugin Strapi qui lance le déploiement du site et affiche ses exécutions dans l'admin.
  • Les secrets n'atteignent jamais le navigateur, car le build est le seul processus qui les détient. Le jeton du CMS est une variable d'environnement Astro réservée au serveur.
  • Deux exceptions, toutes deux sans secret. Le formulaire de contact écrit dans le CMS et se défend par un pot de miel et une limite de débit plutôt que par un jeton, et il répond au visiteur par e-mail dans la langue où il a écrit. La connexion facultative, par e-mail et mot de passe ou avec GitHub, garde son identifiant dans un cookie httpOnly sur le domaine du CMS et son jeton d'accès de courte durée en mémoire, jamais dans un stockage.
  • Mesuré, pas supposé. Le mode sombre affichait la palette claire pendant 532 ms mesurées avant qu'une classe ne s'applique ; c'est désormais une media query prefers-color-scheme résolue avant le premier rendu, ce qui a supprimé du code au lieu d'en ajouter.

Dans l'application web

apps/web/src compte quatre couches, et c'est leur sens de dépendance qui compte.

features/
15 modules métier : projets, blog, à propos, contact, recherche...

shell/
en-tête, pied de page, SEO, analytics

design-system/
primitives + patterns, sans connaissance métier

core/
contrôleurs, client Strapi, loaders

  • Les noms de fichiers sont des rôles. Dans une feature, repository.ts est la couche de récupération qu'appelle un loader de contenu, et service.ts relit le résultat dans le content store ; une feature n'en atteint une autre que par son service.ts. Un fichier difficile à nommer fait généralement deux choses.
  • Pas de barrels, par conception. Un test suit chaque import statique et dynamique depuis chaque point d'entrée navigateur et échoue s'il atteint astro:content ou une variable réservée au serveur : un module serveur ne peut donc jamais se glisser dans un bundle.
  • Quatre langues, un seul répertoire de pages. Une intégration Astro écrite dans le dépôt parcourt src/pages/ et injecte une route /{locale} pour chaque langue autre que l'anglais, avec des slugs traduits tirés d'un seul manifeste qui alimente aussi les motifs d'URL de Paraglide. L'anglais reste sans préfixe, et un lien vers une page renommée est une erreur de compilation.
  • La recherche est un fichier statique par langue, assemblé au build à partir des projets, des articles, des entrées de la chronologie et des tags. Les images Open Graph sont elles aussi générées page par page au build.

Le CMS

Strapi 5 tourne comme une application à part, sur sa propre pile React, et ne partage rien avec le site sinon les données.

apps/admin

bouton Deploy

19 types de contenu
projets, blog, chronologie, notes de fichiers...

Plugins
traduction IA, déploiement web, email designer

pnpm generate
client typé

apps/web

GitHub Actions

  • Un seul contrat, généré. pnpm --filter admin generate lit le schéma d'un Strapi en marche et écrit un client typé dans l'application web. Modifiez un type de contenu, régénérez, et les erreurs de typage disent quoi corriger.
  • Pensé pour quatre langues. strapi-plugin-ai-translate, un paquet de ce dépôt, traduit une entrée vers les autres langues avec un LLM depuis la vue d'édition, le prompt et le modèle se réglant dans l'admin. Ses dix modèles d'e-mail, dont les réponses au formulaire de contact, sont écrits à la main.
  • Du contenu qui fait tourner le site : les projets, les articles, la chronologie des expériences et des études, les témoignages, les données de contributions GitHub et les notes de fichiers derrière la page qui se documente elle-même.

CI/CD

Les changements arrivent sur dev par des pull requests, et une pull request de dev vers master les met en ligne. Les contrôles et les déploiements sont des workflows séparés, et cette seule séparation garde les deux simples.

De la branche au CDN

admin modifié

Branche de travail

PR vers dev

Checks

dev

PR vers master

Checks

master

Workflow de déploiement

Déploiement du CMS

Déploiement du site

La vie d'une pull request

S3 + CloudFrontWorkflow de déploiementCache TurborepoJob ChecksGitHubDéveloppeurOuvre la PR1S'exécute sur le commit de fusion2Arborescence à jour, Prettier3lint, typage, tests, rejoue ce qui est passé4Construit tout le site5Un seul contrôle requis6Fusionne, puis envoie dev vers master7Push sur master8Synchronise le build, invalide le cache9Le site répond 20010
  • Un seul job de contrôle, volontairement. Il y en avait trois plus une porte d'agrégation, et chacun payait une installation complète d'Astro et de Strapi. Un seul job la paie une fois, tandis que Turborepo lance quand même lint, typage et tests côte à côte à l'intérieur, avec --continue pour que chaque échec apparaisse dans une seule exécution.
  • Prettier passe en premier, et l'ordre compte. Il ne lit que son propre fichier d'exclusions : il doit donc tourner avant que quoi que ce soit n'écrive des fichiers générés dans l'arbre de travail.
  • Le site entier est construit à chaque pull request, car le contrôle de types n'affiche jamais une page : un composant qui plante sur un champ CMS manquant passe le contrôle et casse le build. Le CMS n'y est pas construit, car cela confierait ses secrets de production à chaque pull request.
  • La CI ne tourne que sur les pull requests. Une pull request est vérifiée sur sa fusion avec la base : l'arbre qui arrive sur master est donc celui déjà vérifié, et la protection de branche empêche la base de bouger dessous.
  • Le déploiement du site n'est jamais filtré. La page qui se documente elle-même est construite à partir de chaque fichier suivi du dépôt : un commit qui ne touche que la documentation change quand même une page publiée. Le déploiement du CMS, une image de 1 Go et un redémarrage, ne tourne que lorsque ses chemins changent.
  • Du cache à trois niveaux : le store pnpm, le cache distant de Turborepo avec des artefacts signés, et le cache de build d'Astro. Renovate n'ouvre une mise à jour qu'une fois la version âgée d'une semaine.

La mise en production

Déploiement du site

Déploiement du CMS

échec

Construire l'image Strapi

L'envoyer par SSH
vers une commande forcée

Recréer le conteneur

Health check

Retour à l'image précédente

astro build

Synchro vers S3
assets hachés d'abord

Invalider CloudFront

200 en moins de 40 s ?

  • Le CMS part en conteneur sur un VPS, avec une clé qui ne peut lancer que le script de déploiement, à côté de sa propre base PostgreSQL, sauvegardée chaque nuit. Un health check en échec remet l'image précédente.
  • Le site se déploie après le CMS, pour qu'un build ne lise jamais un schéma que le CMS ne sert pas encore. Il envoie les assets hachés avant le HTML qui y renvoie, invalide CloudFront et échoue si le site ne répond pas en moins de 40 secondes.

Construit avec des agents IA

Le dépôt est pensé pour les agents de code autant que pour les personnes.

  • Une documentation qui oriente. Un AGENTS.md racine, court, renvoie vers un guide par application et vers six skills écrits pour ce dépôt : feature-modules (où va le code), client-controllers (le comportement dans le navigateur), design-system, output-neutral-refactor (des refactors qui ne doivent pas changer le HTML rendu), cms-annotations (garder les notes de fichiers alignées sur l'arborescence) et draft-content.
  • Du contenu rédigé par un agent, publié par une personne. draft-content étudie un dépôt ou un sujet, rédige une page de projet ou un article en quatre langues et l'enregistre dans le CMS en brouillons non publiés via le point d'accès MCP intégré à Strapi ; cette page a été écrite ainsi puis relue avant publication.
  • Des skills de design et de mouvement. Seize skills d'Emil Kowalski sur l'animation, l'interaction et la finition sont épinglés dans un fichier de verrouillage.

Fonctionnalités clés :

  • Quatre langues avec des URL traduites, de droite à gauche en arabe, et l'anglais sans préfixe
  • Des pages prérendues sur S3 et CloudFront, avec du JavaScript seulement dans les îlots qui en ont besoin
  • Des transitions de vue, un mode sombre sans flash et un globe des lieux où les projets ont eu lieu
  • Une page qui se documente elle-même : l'arborescence réelle du dépôt avec des notes venues du CMS
  • Une recherche statique et des images Open Graph par page, générées au build
  • Un formulaire de contact qui répond dans la langue du visiteur, et une connexion facultative par e-mail ou GitHub
  • Un admin Strapi avec traduction par IA et un bouton Deploy qui reconstruit le site

Stack technique :

  • Web : Astro 7, React 19, Tailwind v4, Paraglide, TypeScript, Embla, Mermaid, Shiki
  • CMS : Strapi 5, PostgreSQL, Resend, OpenRouter pour la traduction
  • Infrastructure : AWS S3 et CloudFront, Docker sur un VPS, sauvegardes nocturnes vers Cloudflare R2
  • Outillage : Turborepo, pnpm, ESLint, Prettier, Vitest, Renovate, GitHub Actions

En chiffres (novembre 2026) : environ 980 commits depuis avril 2026, 151 pull requests fusionnées, 61 fichiers de test, 15 modules métier, 19 types de contenu et 5 workflows GitHub Actions.

— Stack
AstroStrapiDevOpsTurborepo