ProfileCrest Developer Blog — Tutorials & Guides
STATS & WIDGETS August 2, 2026 10 min read CodeCrest Engineering Team

GitHub Readme Stats: Custom Themes, Caching & CJK Fonts

GitHub Readme Stats is the most popular stats card generator for GitHub. Learn how to customize theme colors, enable private repository commits, optimize caching to prevent API rate limits, and resolve CJK font issues.

What is GitHub Readme Stats?

Created by Anurag Hazra, github-readme-stats dynamically generates SVG cards showing your total stars, commits, pull requests, issues, and top languages.

Key Parameters Overview

https://github-readme-stats.vercel.app/api?username=YOUR_USERNAME&show_icons=true&theme=tokyonight&count_private=true&cache_seconds=86400

Including Private Repository Contributions

By default, stats cards only count commits from public repositories. To include commits from private repos:

  1. Add count_private=true to your card URL query string.
  2. Ensure you have enabled "Include private contributions on my profile" in your GitHub Account Settings under Profile settings.

Preventing Rate Limits with Remote Caching

GitHub's Camo image proxy makes requests on behalf of every profile visitor. Without caching, the API endpoint will hit GitHub API rate limits (5,000 requests/hour), causing broken card images.

Always include cache_seconds=86400 (24-hour cache duration) in your stats URL. This dramatically improves reliability and card load times.

Generate Pre-Cached Stats Cards

ProfileCrest automatically builds cached, theme-matched stats card URLs for your profile.

🚀 Open ProfileCrest Generator
Previous: Visitor Counter GuideNext: Streak Stats & Trophies