Fast GitHub Stats Graph 🚀

Create beautiful GitHub stats cards, badges, icons, and contribution graphs that are easy to customize and perfect for your profile README or project docs.

🌟 Examples Icons Usage

✨ Icon Collections

Render multiple icons into one SVG image using the name query parameter.
for more detail checkout Here

Icons Sizes [small | medium | large]

![icon-collection-basic](https://stats.pphat.top/icons?name=react,typescript,github&size=small)

Preview Example

Columns [1 | 2 | 3 | 4 | 5 | 6|...] maximum 50

Customize with 3 columns

![icon-collection-basic](https://stats.pphat.top/icons?name=react,typescript,github,javascript,nextjs,nuxt&columns=3)

Preview Example

Color Mapping

Mapped colors (index by index):

![icon-collection-colors](https://stats.pphat.top/icons?name=react,typescript,github&color=%230088CC,%233178C6,white)

Example Demo

Partial colors (remaining icons use fallback colors):

![icon-collection-partial-colors](https://stats.pphat.top/icons?name=react,typescript,github,tailwindcss,postgresql&color=%2300AACC,%23EAB308)

Example Demo

Effects [glow | wave]

![icon-collection-glow](https://stats.pphat.top/icons?name=react,typescript,github,tailwindcss&effect=glow&columns=2)

Example Demo

Wave:

Glow:

Combined Example

Size + colors + wave + columns:

👍 Icon by names

Normal Icon

for more detail checkout Here

![icon-react](https://stats.pphat.top/icons/react?color=%230088CC)
![icon-python](https://stats.pphat.top/icons/python?color=%234584B6)

Example Demo

Effect icon

![icon-react](https://stats.pphat.top/icons/react?color=%230088CC&glow=true&glowColor=%230088CC)
![icon-python](https://stats.pphat.top/icons/python?color=%234584B6&glow=true&glowColor=%234584B6)

Example Demo

📊 Stats Card Examples

for more detail checkout Here

Default

![stats-default](https://stats.pphat.top/stats?username=pphatdev)

Theme + Avatar Mode

![stats-theme](https://stats.pphat.top/stats?username=pphatdev&theme=tokyonight&avatar_mode=radar)

Minimal Card

![stats-minimal](https://stats.pphat.top/stats?username=pphatdev&hide_title=true&hide_rank=true&hide_border=true)

Combined Example

![stats-combined](https://stats.pphat.top/stats?username=pphatdev&theme=dracula&custom_title=My%20GitHub%20Stats&data_border_style=frame&data_border_frame=out&show_icons=true)

💻 Languages Card Examples

for more detail checkout Here

Default

![languages-default](https://stats.pphat.top/languages?username=pphatdev)

Card and Pie

![languages-card](https://stats.pphat.top/languages?username=pphatdev&type=card)
![languages-pie](https://stats.pphat.top/languages?username=pphatdev&type=pie)

Theme + Info Style

![languages-themed](https://stats.pphat.top/languages?username=pphatdev&theme=dracula&show_info=true&info_outline=frame)

📈 Contribution Graph Examples

for more detail checkout Here

Default

![graph-default](https://stats.pphat.top/graph?username=pphatdev)

Animated Variants

![graph-wave](https://stats.pphat.top/graph?username=pphatdev&animate=wave&theme=aurora)
![graph-pulse](https://stats.pphat.top/graph?username=pphatdev&animate=pulse&theme=matrix)

🏷️ Badge Examples

for more detail checkout Here

Popular Badge Types

![badge-visitors](https://stats.pphat.top/badge/visitors?username=pphatdev)
![badge-repositories](https://stats.pphat.top/badge/repositories?username=pphatdev)
![badge-followers](https://stats.pphat.top/badge/followers?username=pphatdev)
![badge-total-stars](https://stats.pphat.top/badge/total-stars?username=pphatdev)

Theme + Custom Label

![badge-custom-label](https://stats.pphat.top/badge/repositories?username=pphatdev&theme=ocean&customLabel=Public%20Repos)

Color and Layout Controls

![badge-colors](https://stats.pphat.top/badge/total-issues?username=pphatdev&labelBackground=0d1117&labelColor=ffffff&valueBackground=1f2937&valueColor=22c55e)
![badge-minimal](https://stats.pphat.top/badge/total-pull-requests?username=pphatdev&theme=tokyonight&hideFrame=true&hideIcon=true)

📁 Project Badge Examples

for more detail checkout Here

Popular Project Badge Types

![project-visitors](https://stats.pphat.top/project/visitors?repo=pphatdev/github-stats)
![project-stars](https://stats.pphat.top/project/stars?repo=pphatdev/github-stats)
![project-forks](https://stats.pphat.top/project/forks?repo=pphatdev/github-stats)
![project-watchers](https://stats.pphat.top/project/watchers?repo=pphatdev/github-stats)

Theme + Custom Label

![project-custom](https://stats.pphat.top/project/contributors?repo=pphatdev/github-stats&theme=ocean&customLabel=Contributors)

Visitors Rule (Same IP)

Project visitors increment once per same IP every 5 minutes.

![project-visitors](https://stats.pphat.top/project/visitors?repo=pphatdev/github-stats)

Development

Development setup was moved to: docs/how-to/DEVELOPMENT.md

Route-by-route demos with option examples: docs/example/README.md

Architecture

• API: GitHub REST + GraphQL APIs with intelligent batching
• Caching: Multi-tier (Memory → Redis → Source) with 2-hour default TTL
• Database: SQLite with Drizzle ORM for badge counters and visitor logs
• Server: Express.js with optional cluster mode for multi-core scaling
• Rendering: Server-side SVG generation with optional WebP/PNG/GIF export

Notes

• Responses are cached for 2 hours (configurable via CACHE_DURATION)
• Without a GitHub token, API rate limits are very low (~60 requests/hour)
• Set GITHUB_TOKEN to get 5,000 requests/hour
• Redis is optional but recommended for production (enables distributed caching)
• User visitor badges (/badge/visitors) use IP hashing for privacy-preserving unique visitor counting
• Project visitor badges (/project/visitors) increment once per same IP every 5 minutes

License

MIT. See LICENSE.