11 / 11
github-profile-cards
Open source · 2026
Des cartes GitHub de statistiques et de langages, auto-hébergées sur Cloudflare Workers : le travail privé compte en totaux, et aucun nom de dépôt n’apparaît jamais.
- B- → B+Note GitHub une fois le travail privé compté
- 100 %Score de mutation sur 15 modules critiques
- 313Tests automatisés

Aperçu
Le problème
L’essentiel de mon travail se trouve dans des dépôts clients privés : les cartes de statistiques publiques n’en comptaient qu’environ un cinquième. Puis l’instance publique de github-readme-stats est tombée, et mes cartes sont devenues des images cassées. Je voulais un profil qui montre ce que je livre vraiment, sans révéler le nom d’un client ou d’un dépôt.
La solution
Un petit Worker Cloudflare qui tourne sur l’offre gratuite. Une tâche cron récupère les chiffres toutes les 6 heures avec deux jetons en lecture seule, les valide, génère des cartes claires et sombres et les stocke dans KV. Les requêtes lisent uniquement ce qui est stocké : il n’y a donc rien à limiter. Les cartes affichent des totaux publics, privés et globaux, jamais de noms.
Chacun peut déployer sa propre copie avec un bouton Deploy to Cloudflare et deux jetons.
Le résultat
Les cartes sont en ligne sur mon profil GitHub, et ma note est passée de B- à B+ une fois le travail privé compté. La version 1.0.0 est publique, et le bouton de déploiement a été testé de bout en bout sur un compte Cloudflare distinct. Les tests couvrent les comportements critiques, avec un score de mutation de 100 % sur 15 modules critiques.
Architecture
- ActualisationUne tâche cron toutes les 6 heures récupère les chiffres avec deux jetons GitHub en lecture seule
- ValidationLes nouvelles données ne remplacent les anciennes que si elles sont valides ; une chute soudaine est retenue tant qu’elle ne se répète pas
- StockageSVG clairs et sombres, générés à l’avance et conservés dans Workers KV
- DiffusionLes requêtes lisent uniquement KV, avec une carte de remplacement s’il est vide, jamais une image cassée
Décision clé
Générer les cartes à l’avance et ne stocker que des totaux. Les requêtes n’atteignent jamais GitHub : les cartes ne peuvent pas heurter une limite de débit, et aucun nom de dépôt n’entre dans les données stockées.
