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.
Docker build guide: docs/docker-build.md
Render multiple icons into one SVG image using the name query parameter.
for more detail checkout Here
Icons Sizes [small | medium | large]
Preview Example
Columns [1 | 2 | 3 | 4 | 5 | 6|...] maximum 50
Customize with 3 columns
Preview Example
Mapped colors (index by index):
Example Demo
Partial colors (remaining icons use fallback colors):
Example Demo
Example Demo
Wave:
Glow:
Size + colors + wave + columns:
Normal Icon
for more detail checkout Here
Example Demo
Effect icon
Example Demo
for more detail checkout Here
💻 Languages Card Examples
for more detail checkout Here
📈 Contribution Graph Examples
for more detail checkout Here
Generate customizable GitHub badges for users and repositories with real-time data, caching, and visual effects.
For more details: User Badges · Badge Collections · Project Badges · Full Spec
/badges?username={username}&repo={repo}&name={badge1,badge2,...}&theme={theme}&effect={wave|glow}&column={1-50}&size={small|medium|large}&p={0-100}
Parameter
Default
Description
| username |
(required) |
GitHub username |
| repo |
— |
Repository name (e.g., owner/repo) |
| name |
— |
Comma-separated badge names |
| theme |
default |
Comma-separated theme(s) (e.g., ocean, galaxy, aurora) |
| effect |
— |
Animation effect: wave or glow |
| column |
50 |
Number of columns (1–50) |
| size |
small |
Badge size: small, medium, or large |
| p |
0 |
Container padding in pixels (0–100) |
| realtime |
false |
Bypass cache for fresh data (30s cooldown) |
User Badges: visitors · repositories · followers · organization · languages · total-stars · total-contributors · total-commits · total-code-reviews · total-issues · total-pull-requests · total-joined-years
Repository Badges (requires repo): stars · forks · contributors · issues · pull-requests · watchers · size
Multiple Badges with Theme
Multiple Themes (cycled per badge)
Combined Example (layout + themes + effect + padding)
Documentation:
- 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 round-robin cluster load balancing in production
- Rendering: Server-side SVG generation with optional WebP/PNG/GIF export
- 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)
- Docker and npm start now boot the clustered entrypoint; set WORKERS to cap worker count, or leave it at 0 to use all available CPU cores
- User visitor badges (/badges?username=...&name=visitors) use IP hashing for privacy-preserving unique visitor counting
- Project visitor badges (/project/visitors) increment once per same IP every 5 minutes
MIT. See LICENSE.