Create beautiful GitHub stats cards, badges, icons, and contribution graphs that are easy to customize and perfect for your profile README or project docs.
Render multiple icons into one SVG image using the name query parameter. for more detail checkout Here
Preview Example
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
for more detail checkout Here
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
Documentation:
- Development Setup Guide - Environment setup, database, and run commands
- Project Structure - Complete codebase architecture and organization
- Route Examples - Route-by-route demos with option examples
- 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
- 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_TOKENto get 5,000 requests/hour - Redis is optional but recommended for production (enables distributed caching)
- 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.
Generate dynamic, futuristic SVG cards displaying GitHub user statistics for your README files!