starcharts

Plot your repo stars over time!

Features

Smart Sampling Mode (Large Repository Optimization)

For large repositories with massive amounts of stars, this project uses Smart Sampling Mode to efficiently fetch star history data and render trend charts.

How it works:

1. Auto Detection: First requests the first page of GitHub API data and parses the Link Header to get total page count
2. Mode Switching:
   • When total pages ≤ maxSamplePages (default 15 pages, ~1500 stars), fetches all data
   • When total pages > maxSamplePages, automatically switches to sampling mode
3. Uniform Sampling: Evenly selects sample points across all pages to ensure coverage of the complete star growth timeline
4. Data Point Extraction: Extracts the timestamp and corresponding star count from the first Stargazer of each sampled page
5. Trend Completion: Adds current time and total star count as the final data point to ensure the chart extends to the latest state

Usage

go run main.go

Then browse http://localhost:3000/me/myrepo .

Configuration

Configure via environment variables:

| Variable | Default | Description | |----------|---------|-------------| | REDIS_URL | redis://localhost:6379 | Redis cache URL | | GITHUB_TOKENS | - | GitHub API Token (supports multiple, comma-separated) | | GITHUB_PAGE_SIZE | 100 | Number of stars per page | | GITHUB_MAX_SAMPLE_PAGES | 15 | Max sample pages (triggers sampling mode when exceeded) | | GITHUB_MAX_RATE_LIMIT_USAGE | 80 | API Rate Limit usage threshold percentage | | LISTEN | 127.0.0.1:3000 | Server listen address |

Example