GitHub Stats API

Generate dynamic GitHub stats and language cards for README embeds.

Returns JSON describing the live route list and static asset roots.

Example:

GET https://stats.pphat.top/

Returns an SVG (default) or WebP stats card for a user.

Required query params:

• username

Optional query params:

• theme
• hide_title
• hide_border
• hide_rank
• show_icons
• avatar_mode (none | avatar | radar)
• show_avatar (legacy alias, true sets avatar_mode=avatar)
• custom_title
• data_border_style (solid | frame)
• data_border_frame (in | out)
• bgColor
• borderColor
• textColor
• titleColor
• format (svg | webp)

Example:

GET https://stats.pphat.top/stats?username=pphatdev&theme=dark

Returns an SVG languages card or pie chart for a user.

Required query params:

• username

Optional query params:

• theme
• show_info
• top
• variant
• type (card | pie)
• bgColor
• borderColor
• textColor
• titleColor
• format

Example:

GET https://stats.pphat.top/languages?username=pphatdev&theme=default

Returns an SVG activity graph for a user for a specific year or the last 365 days.

Required query params:

• username

Optional query params:

• theme — see Graph Themes below
• year — 4-digit year (default: last 365 days)
• animate — cell animation mode: glow (default) | wave | pulse | none
• size — canvas size preset: default (1200×600) | small (800×400) | medium (1000×500) | large (1400×700)
• show_title — show/hide the username + year heading (true default, false centers remaining content)
• show_total_contribution — show/hide the contributions subtitle (true default, false also shrinks SVG height to fit content)
• show_background — show/hide the background gradient, stars, and grid lines (true default, false makes bg transparent and shrinks SVG width to fit only the cells with 10px margin)
• as — output format: svg (default) | gif (animated) | webp (animated) | png (static)
• bgColor
• borderColor
• textColor
• titleColor

Example:

GET https://stats.pphat.top/graph?username=pphatdev&year=2024
GET https://stats.pphat.top/graph?username=pphatdev&theme=aurora
GET https://stats.pphat.top/graph?username=pphatdev&theme=matrix&animate=pulse
GET https://stats.pphat.top/graph?username=pphatdev&theme=ocean&animate=wave
GET https://stats.pphat.top/graph?username=pphatdev&theme=aurora&animate=wave&as=gif
GET https://stats.pphat.top/graph?username=pphatdev&theme=matrix&animate=pulse&as=webp
GET https://stats.pphat.top/graph?username=pphatdev&as=png

Stats card:

![GitHub Stats](https://stats.pphat.top/stats?username=YOUR_USERNAME)

Languages card:

![Top Languages](https://stats.pphat.top/languages?username=YOUR_USERNAME)

Languages pie chart:

![Top Languages](https://stats.pphat.top/languages?username=YOUR_USERNAME&type=pie)

Activity graph:

![Activity Graph](https://stats.pphat.top/graph?username=YOUR_USERNAME)

Activity graph with theme and animation:

![Activity Graph](https://stats.pphat.top/graph?username=YOUR_USERNAME&theme=aurora&animate=pulse)

Use the theme query param. A few previews:

🎨 default	🌙 dark	⚡ radical	🌆 tokyonight
🧛 dracula	🌈 monokai	🍂 gruvbox	🖤 onedark

Full theme list is in src/utils/themes.ts.

These themes are tuned for the /graph heatmap card — vivid iconColor cells against near-black backgrounds.

🌌 aurora	💚 matrix
🔥 inferno	🌊 ocean

All available themes: aurora · matrix · inferno · ocean · neon · solar · galaxy · github-dark

• Node.js 16+
• GitHub Personal Access Token (recommended)

npm install

Create a .env file:

GITHUB_TOKEN=your_github_personal_access_token
PORT=3000
APP_ENV=development

Build and run:

npm run build
npm start

Development mode:

npm run dev

• The API uses GitHub REST and caches responses for 20 minutes.
• Without a token, GitHub rate limits are low; set GITHUB_TOKEN for higher limits.

MIT. See LICENSE.