🇪🇸 Versión en Español

GitHub Readme Activity Graph - ema version

A dynamically generated activity graph for your GitHub profile with customizable periods, multi-user comparisons, 37+ themes, and real-time generator.
Personal fork of Ashutosh00710/github-readme-activity-graph.

View Feature Walkthrough • Web Interactive Builder

See it live on my GitHub profile

Usage

Paste the following Markdown snippet into your profile README:

![Activity Graph](https://graf-activity-github.vercel.app/graph?username=<YOUR_USERNAME>)

Live Public Vercel Deployment:
https://graf-activity-github.vercel.app

Individual Example:

![ema28pro's Activity Graph](https://graf-activity-github.vercel.app/graph?username=ema28pro&theme=github-dark&area=true&hide_border=true)

Multi-User Comparison Example:

![Comparison](https://graf-activity-github.vercel.app/graph?username=ema28pro,octocat&theme=dracula)

---

Fork Features

This fork includes several advanced features detailed in the Walkthrough:

• Date Presets & Ranges: Use ?days=last-week (7 days) or ?days=last-15-days (15 days) without calculating dates manually. Also supports custom date ranges with ?from=YYYY-MM-DD&to=YYYY-MM-DD or any number of days (?days=45).
• Multi-User Comparisons: Compare the activity of up to 4 users on a single chart with ?username=user1,user2.
• Per-User Color Customization: Customize curve lines and dots per user using user2~lineColor_dotsColor (e.g. user2~ff0000_ for red line with white dots).
• Custom vs_friends Title: Simplify multi-user headings to User vs Friends with &vs_friends=true, customize the phrase with %20 or +, or remove the prefix using _ (e.g. &vs_friends=_with%20friends).
• Smart Layer Ordering (front): By default, the primary user curve stays in the foreground; set &front=false to layer it in the background.
• Customizable Legend: Displayed automatically in multi-user mode, and can be toggled off with ?hide_legend=true or ?legend=false.
• Health & Telemetry Endpoint: Endpoint /health provides token validity status, server uptime, and remaining GitHub API rate-limit quota in JSON format.
• Standalone Web Builder: Full bilingual (EN/ES) real-time configuration studio inside the web/ folder with dark/light themes, color palette pickers, and Vite deployment pipeline.

---

Available Themes

Choose from dozens of ready-to-use themes (such as github-dark, dracula, lucent, tokyo-night, react-dark, nord, etc.).

View Full Theme Catalog with Previews (THEMES.md)

To apply any theme, add the &theme=<name> query parameter to the URL:

![Activity Graph](https://graf-activity-github.vercel.app/graph?username=ema28pro&theme=github-dark)

---

Customization

Customize the graph with URL query parameters:

Parameter	Description	Value Type
bg_color	Background color	hex code (without #)
border_color	Border color	hex code (without #)
color	Text and axis line color	hex code (without #)
title_color	Title text color	hex code (without #)
line	Primary curve line color	hex code (without #)
point	Primary data points color	hex code (without #)
area_color	Gradient fill color under the curve	hex code (without #)
area	Show gradient shaded area under curve	boolean (default: false)
hide_border	Make the outer border frame transparent	boolean (default: false)
hide_title	Hide the top title header	boolean (default: false)
custom_title	Custom header title	string (use %20 for spaces)
theme	Theme preset name	string (see THEMES.md)
radius	Corner border radius	number (0 to 16)
height	Height of the SVG graph	number (200 to 600, default: 420)
days	Number of days to display	number (1-90) or preset (last-week)
from	Start date	YYYY-MM-DD
to	End date	YYYY-MM-DD
grid	Show background grid lines	boolean (default: true)

New Fork Parameters & Endpoints

Exclusively added in this fork:

Parameter / Route	Description	Value Type
username	Multi-user comparison (up to 4 users)	Comma-separated string: user1,user2
vs_friends	Formatted companion title with reduced font. Supports spaces with %20 or +. Prefix with _ to drop vs.	true, _, or custom text (e.g. my%20team, _friends)
days / period	Date presets	last-week (7 days) or last-15-days (15 days)
hide_legend	Toggle legend visibility in multi-user mode	boolean (default: false) or legend=false
front	Keep primary user line on top (true/top) or in background (false/bottom)	boolean or string: true, false, top, bottom
GET /health	Real-time health check, uptime & API rate-limit quota	Returns JSON response

Tip

Primary Line Layering (front, order or user_front):

• In Front (default / front=true / order=top): The primary user's line and area are rendered in front (on top) of companion lines.
• In Background (front=false, order=bottom): Renders the primary user's line in standard chronological sequence behind companion lines.

Tip

Friends Title Format (vs_friends / friends):

• Default (vs_friends=true): Displays User vs Friends.
• Custom phrase: Use %20 or + for spaces: &vs_friends=my%20team renders User vs my team.
• Remove "vs": Prepend an underscore _ (e.g. &vs_friends=_with%20friends) to render User with friends.

Tip

Individual Per-User Colors in Comparisons (username): Customize lines and points for companion users (from 2nd onward) with username~lineColor_dotsColor:

• user2~ff0000: Changes curve line to #ff0000 (dots keep default color).
• user2~ff0000_: Line #ff0000 and dots in white (#ffffff).
• user2~_: Default line and dots in white (#ffffff).
• user2~ff0000_00ff00: Line #ff0000 and dots in #00ff00. (Note: Using ~ in URLs is recommended to avoid encoding # as %23).

View /health JSON response example

{
  "status": "ok",
  "token_valid": true,
  "total_requests": 42,
  "total_graphs_served": 35,
  "rate_limit": {
    "remaining": 4995,
    "limit": 5000,
    "used": 5,
    "reset": "2026-09-08T18:48:08.000Z"
  },
  "uptime_seconds": 3600
}

---

Credits

This project is a fork of Ashutosh00710/github-readme-activity-graph.

To contribute, report issues, or view original documentation, visit the original repository.

License

MIT — Original project by Ashutosh Dwivedi