Brouillon à relire par Paul
Ce texte est un brouillon. Paul Périgault le relira et le réécrira avant publication.
Design system
Cette page résume le système, ses décisions et ses preuves. Chaque affirmation renvoie à une source du dépôt.
Ce que c’est
C’est le design system de paulperigault.fr, conçu pour des sites d’un seul auteur et écrit en Astro. Il comprend six paquets : tokens, css, astro, guards, create et mcp. Le README et AGENTS.md à la racine du dépôt les décrivent.
Comment il travaille
L’infrastructure est décrite en code et la sécurité s’applique par défaut. Les choix sont écrits : ADR dans docs/adr, choix ouverts dans docs/decisions-log.md, journal daté dans docs/journal.
L’accessibilité vise WCAG 2.2 AA et se mesure. Le mot « prouvé » exige une source : norme, auteur, année. Sans source, le texte dit « convention » ou « préférence » (règle éditoriale d’AGENTS.md).
Pour le détail : décisions, preuves etarchitecture.
Ce que le design système prouve
- 45 composants, comptés dans la liste GROUPS de apps/docs/src/navigation.ts.
- Des tests e2e sur 13 appareils, définis dans apps/docs/e2e/devices.ts (téléphones, tablette, ordinateurs).
- Une CSP sans unsafe-inline, construite dans apps/docs/scripts/headers/policy.mjs et vérifiée par policy.test.mjs.
- Zéro JavaScript par défaut dans les composants, règle d’AGENTS.md.
Les mesures complètes sont sur la page preuves.
Qui
Paul Périgault travaille en DevOps et DevSecOps.Son site et la pageauteur donnent le détail.