A high-performance .NET 9 Web API that generates beautiful, customizable SVG cards displaying GitHub user and repository statistics — perfect for embedding in your README.

Try it out at github-readme-stats.tuhidulhossain.com — enter any GitHub username, pick a theme, and get your embed code instantly.

• Streak Stats Card — Current streak, longest streak, and total contributions with animated SVG
• User Stats Card — Stars, commits, PRs, issues, reviews, and rank with a visual ring
• Top Languages Card — Most used programming languages with multiple layout options
• Repository Pin Card — Showcase pinned repositories with stars, forks, and language info
• Gist Card — Display gist statistics
• 60+ Themes — GitHub, editor, framework, and custom color themes
• Fully Customizable — Colors, borders, layouts, animations, and more
• High Performance — Redis caching, rate limiting, token rotation, and resilience patterns

Add any of these to your GitHub README:

![GitHub Streak](https://github-readme-stats.tuhidulhossain.com/api/streak?username=YOUR_USERNAME)

![GitHub Stats](https://github-readme-stats.tuhidulhossain.com/api/stats?username=YOUR_USERNAME&show_icons=true)

![Top Languages](https://github-readme-stats.tuhidulhossain.com/api/top-langs?username=YOUR_USERNAME)

![Repo Card](https://github-readme-stats.tuhidulhossain.com/api/pin?username=YOUR_USERNAME&repo=REPO_NAME)

![Gist Card](https://github-readme-stats.tuhidulhossain.com/api/gist?id=GIST_ID)

These parameters work across all card types:

Use the theme parameter to customize your card appearance:

![GitHub Streak](https://github-readme-stats.tuhidulhossain.com/api/streak?username=encryptedtouhid&theme=tokyonight)

Theme	Preview
github_light
github_dark
tokyonight
dracula
nord
radical
sunset_dark
ocean_deep
cyber
aurora

• .NET 9.0 SDK
• A GitHub Personal Access Token
• Redis (optional — falls back to in-memory cache)

1. Clone the repository

git clone https://github.com/encryptedtouhid/github-readme-stats.git
cd github-readme-stats

2. Configure your GitHub token

Create src/GitHubStats.Api/appsettings.Development.json:

{
  "GitHub": {
    "PersonalAccessTokens": ["ghp_your_token_here"]
  }
}

Or set the environment variable:

export GitHub__PersonalAccessTokens__0=ghp_your_token_here

3. Build and run

cd src
dotnet build GitHubStats.sln
cd GitHubStats.Api
dotnet run

The API will be available at http://localhost:5042.

4. Run tests

cd src
dotnet test GitHubStats.Tests

Configure via appsettings.json or environment variables:

src/
├── GitHubStats.Api             # HTTP endpoints, middleware, and startup
├── GitHubStats.Application     # Business logic and card service orchestration
├── GitHubStats.Domain          # Entities, interfaces, and domain services
├── GitHubStats.Infrastructure  # GitHub API client, caching, and token rotation
├── GitHubStats.Rendering       # SVG card rendering and 60+ theme definitions
└── GitHubStats.Tests           # Unit and integration tests

Key design decisions:

• Clean architecture with clear separation of concerns
• GitHub GraphQL API for efficient data fetching with REST fallback for commit counts
• Token rotation across multiple PATs for rate limit distribution
• Polly resilience patterns (retries, circuit breaker, timeouts)
• Background cache refresh job for tracked users
• OpenTelemetry instrumentation for observability

MIT

Developed by Khaled Md Tuhidul Hossain