Как отслеживать рост открытых проектов с помощью Star History

Когда я выбираю библиотеку для нового проекта или сравниваю альтернативы, количество звёзд на GitHub часто сбивает с толку. Пять тысяч звёзд у проекта пятилетней давности и пять тысяч у репозитория, который появился полгода назад, рассказывают совершенно разные истории. Первый мог давно забросить мейнтейнер, а второй сейчас переживает взрывной рост и активный приток контрибьюторов.

Сам GitHub показывает только текущее число звездочек. Историю динамики из коробки платформа не даёт. Для этого сообщество давно использует Star History — инструмент, который превращает скучные цифры в наглядные графики популярности.

Что умеет сервис

Проект работает как веб-сервис на star-history.com, но весь его исходный код открыт под лицензией MIT. Вы вбиваете имя репозитория и сразу видите кривую набора звёзд во времени.

Вот основные вещи, ради которых к нему обращаются:

Графики в стиле комиксов xkcd. Линии выглядят слегка небрежно от руки, поэтому графики легко узнаются в презентациях и статьях.
Сравнение нескольких репозиториев на одном экране. Можно наложить друг на друга графики конкурентов (например, Vue против React и Svelte) и увидеть, когда именно произошёл перелом тренда.
Переключение режимов отображения. Данные можно смотреть по точным календарным датам или выравнивать по временной шкале от дня создания репозиториев.
Встраиваемые живые SVG-графики и бейджи для README.

Как встроить график в свой README

Многие авторы популярных библиотек вставляют график динамики звёзд прямо в описание проекта. Это сразу показывает посетителям темп роста сообщества.

Делается это с помощью обращения к API сервиса. Вот как выглядит разметка с поддержкой тёмной и светлой тем:

<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>

Кроме графиков, сервис генерирует компактные бейджи с глобальным рангом репозитория.

Что под капотом

Кодовая база проекта разделена на фронтенд, расширение для браузера и бэкенд.

Фронтенд написан на TypeScript с использованием Next.js и стилизован через Tailwind CSS. Разработчики используют пакетный менеджер pnpm.

Чтобы поднять фронтенд локально:

cd frontend
pnpm install
pnpm dev

После этого веб-интерфейс станет доступен по адресу http://localhost:3000.

Для бэкенда, который генерирует SVG-картинки графиков на лету, используется отдельный сервис:

cd backend
pnpm install
pnpm dev

Сервер API запускается на порту 8080.

Интересный момент: в репозитории прямо в README указано, что авторы не принимают внешние пуллреквесты (We do not accept external contribution). Проект поддерживается конкретной командой, поэтому если вам нужны специфические доработки, придётся форкать репозиторий под себя.

Расширение для Chrome

Если не хочется каждый раз переходить на сайт, у проекта есть расширение для браузера Chrome.

Оно добавляет кнопку просмотра истории прямо на страницу любого репозитория GitHub. Собрать его из исходников можно одной командой в папке фронтенда:

cd frontend
pnpm build:ext

Готовый бандл окажется в папке ./dist, откуда его можно загрузить в браузер в режиме разработчика как распакованное расширение.

Практические сценарии

В повседневной работе Star History полезен в четырёх типовых ситуациях:

Оценка здоровья зависимостей. Резкое падение темпа набора звёзд часто совпадает с моментом, когда авторы забросили проект или перестали отвечать на ишью.
Подготовка питчей и докладов. График в стиле xkcd отлично разбавляет сухие технические слайды.
Анализ маркетинга после релизов. Вы запустили проект на Hacker News или Product Hunt и хотите наглядно увидеть отклик аудитории в последующие дни.
Выбор между похожими библиотеками. Когда нужно выбрать между двумя утилитами с похожим функционалом, график помогает понять, какая из них сейчас набирает обороты, а какая постепенно угасает.

Спонсоры и экосистема

Проект активно поддерживается коммерческими компаниями из мира опенсорса, среди которых Bytebase, Dify, SerpApi и pgplex.

Star History решает одну конкретную задачу без лишнего усложнения. Сервис работает быстро, даёт экспортировать картинки в пару кликов и легко встраивается в документацию.

Если вы ведёте открытый репозиторий или часто анализируете чужие исходники, держите сайт в закладках или поставьте расширение для браузера. Это сэкономит время при оценке библиотек и поможет следить за темпами роста собственных наработок.