Skip to content

pphatdev/github-stats

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

408 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Portfolio Portfolio Portfolio Portfolio

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

icon-collection-basic

icon-collection-basic

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

icon-collection-basic

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

icon-collection-colors

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

icon-collection-partial-colors

Effects [glow | wave]

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

Example Demo

Wave:

icon-collection-wave

Glow:

icon-collection-glow

Combined Example

Size + colors + wave + columns:

icon-collection-combined

๐Ÿ‘ 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

icon-react icon-python

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

icon-react icon-python

๐Ÿ“Š Stats Card Examples

for more detail checkout Here

Default

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

stats-default

Theme + Avatar Mode

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

stats-theme

Minimal Card

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

stats-minimal

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)

stats-combined

๐Ÿ’ป Languages Card Examples

for more detail checkout Here

Default

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

languages-default

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)

languages-card languages-pie

Theme + Info Style

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

languages-themed

๐Ÿ“ˆ Contribution Graph Examples

for more detail checkout Here

Default

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

graph-default

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)

graph-wave graph-pulse

๐Ÿท๏ธ 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)

badge-visitors badge-repositories badge-followers badge-total-stars

Theme + Custom Label

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

badge-custom-label

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)

badge-colors badge-minimal

๐Ÿ“ 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)

project-visitors project-stars project-forks project-watchers

Theme + Custom Label

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

project-custom

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.

Releases

No releases published

Packages

 
 
 

Contributors