Comment suivre la croissance des projets open source avec Star History

Pour choisir une bibliothèque pour un nouveau projet ou comparer des alternatives, le nombre d'étoiles sur GitHub peut être trompeur. Cinq mille étoiles sur un projet de cinq ans et cinq mille étoiles sur un dépôt lancé il y a six mois racontent des histoires complètement différentes. Le premier pourrait avoir un mainteneur abandonné, tandis que le deuxième connaît une croissance explosive avec un afflux actif de contributeurs.

GitHub lui-même n'affiche que le nombre d'étoiles actuel. La plateforme ne fournit pas de données historiques de tendances par défaut. C'est pourquoi la communauté s'appuie depuis longtemps sur Star History — un outil qui transforme les chiffres bruts en graphiques visuels de popularité.

Ce que le service peut faire

Le projet fonctionne comme un service web sur star-history.com, mais tout son code source est ouvert sous licence MIT. Vous entrez un nom de dépôt et vous voyez immédiatement la courbe des étoiles accumulées au fil du temps.

Voici les principales utilisations :

• Graphiques en style BD xkcd. Les lignes semblent légèrement dessinées à la main et décontractées, ce qui rend les graphiques instantanément reconnaissables dans les présentations et les articles.
• Comparer plusieurs dépôts sur un même écran. Vous pouvez superposer les graphiques des concurrents (par exemple, Vue vs. React et Svelte) et voir exactement quand un renversement de tendance s'est produit.
• Changer les modes d'affichage. Vous pouvez visualiser les données par dates exactes du calendrier ou les aligner sur une chronologie à partir de la date de création de chaque dépôt.
• Graphiques SVG dynamiques intégrables et badges pour les fichiers README.

Comment intégrer un graphique dans votre README

De nombreux auteurs de bibliothèques populaires intègrent le graphique de l'historique des étoiles directement dans la description du projet. Cela montre immédiatement aux visiteurs le rythme de croissance de la communauté.

Cela se fait en appelant l'API du service. Voici à quoi ressemble le balisage avec la prise en charge des thèmes sombre et clair :

<a href="https://star-history.com/#your-username/your-repo&Date">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=your-username/your-repo&type=Date&theme=dark" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=your-username/your-repo&type=Date" />
   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=your-username/your-repo&type=Date" />
 </picture>
</a>

Au-delà des graphiques, le service génère des badges compacts indiquant le classement mondial du dépôt.

Ce qui se cache sous le capot

Le code du projet est divisé en frontend, extension de navigateur et backend.

Le frontend est écrit en TypeScript avec Next.js et stylisé avec Tailwind CSS. Les développeurs utilisent le gestionnaire de paquets pnpm.

Pour exécuter le frontend en local :

cd frontend
pnpm install
pnpm dev

Après cela, l'interface web sera disponible à l'adresse http://localhost:3000.

Pour le backend, qui génère des images de graphiques SVG à la volée, un service séparé est utilisé :

cd backend
pnpm install
pnpm dev

Le serveur API s'exécute sur le port 8080.

Un détail intéressant : le README indique explicitement que les auteurs n'acceptent pas les pull requests externes (We do not accept external contribution). Le projet est maintenu par une équipe spécifique, donc si vous avez besoin de modifications personnalisées, vous devrez forker le dépôt vous-même.

Extension Chrome

Si vous ne voulez pas visiter le site web à chaque fois, le projet propose une extension de navigateur Chrome.

Elle ajoute un bouton de vue de l'historique directement sur la page de n'importe quel dépôt GitHub. Vous pouvez la compiler à partir du code source avec une seule commande dans le dossier frontend :

cd frontend
pnpm build:ext

Le bundle prêt sera dans le dossier ./dist, d'où vous pourrez le charger dans le navigateur en mode développeur comme extension non empaquetée.

Scénarios pratiques

Dans le travail quotidien, Star History est utile dans quatre situations courantes :

1. Évaluer la santé des dépendances. Une chute brutale du taux d'acquisition d'étoiles coïncide souvent avec le moment où les auteurs ont abandonné le projet ou ont cessé de répondre aux issues.
2. Préparer des pitchs et des présentations. Un graphique en style xkcd est un excellent moyen d'égayer des diapositives techniques austères.
3. Analyse marketing post-lancement. Vous avez lancé un projet sur Hacker News ou Product Hunt et voulez voir visuellement la réponse du public au cours des jours suivants.
4. Choisir entre des bibliothèques similaires. Quand vous devez choisir entre deux utilitaires avec des fonctionnalités similaires, un graphique vous aide à comprendre lequel prend de l'ampleur et lequel s'efface progressivement.

Sponsors et écosystème

Le projet est activement soutenu par des entreprises commerciales dans l'espace open source, notamment Bytebase, Dify, SerpApi et pgplex.

Star History résout un problème spécifique sans complexité inutile. Le service fonctionne rapidement, vous permet d'exporter des images en quelques clics et s'intègre facilement dans la documentation.

Si vous maintenez un dépôt ouvert ou analysez fréquemment le code d'autres personnes, gardez le site en favori ou installez l'extension de navigateur. Cela vous fera gagner du temps lors de l'évaluation des bibliothèques et vous aidera à suivre le taux de croissance de vos propres projets.