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 !


Aperçu de l'architecture
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.
- 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-schemeré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.
- Les noms de fichiers sont des rôles. Dans une feature,
repository.tsest la couche de récupération qu'appelle un loader de contenu, etservice.tsrelit le résultat dans le content store ; une feature n'en atteint une autre que par sonservice.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:contentou 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.
- Un seul contrat, généré.
pnpm --filter admin generatelit 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
La vie d'une pull request
- 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
--continuepour 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
masterest 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
- 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.mdracine, 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) etdraft-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.