Skip to content

About

A dynamically generated activity graph to show your GitHub activities of last 31 days.

Topics

Resources

Code of conduct

Contributing

Stars

2.4k stars

Watchers

13 watching

Forks

Latest commit

Β 

History

534 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Github Readme Activity Graph

A dynamically generated activity graph to show your GitHub activities of last 31 days.

⚠️ NOTICE: DEPLOYMENT MOVED ⚠️

The Vercel URL https://github-readme-activity-graph.vercel.app is deprecated and no longer serves graphs. The graph is now hosted on Cloudflare Workers:

https://github-readme-activity-graph.ashutosh-dwivedi0710.workers.dev

If your README still uses the old URL, replace the domain and keep everything after it. For example:

- ![Activity Graph](https://github-readme-activity-graph.vercel.app/graph?username=<username>&theme=dracula)
+ ![Activity Graph](https://github-readme-activity-graph.ashutosh-dwivedi0710.workers.dev/graph?username=<username>&theme=dracula)

Older deployments at https://activity-graph.herokuapp.com (Heroku free tier discontinued) and https://github-readme-activity-graph.cyclic.app (Cyclic.sh shut down in early 2025) are also gone. For background see issue #197.

Please refer to the updated link here

Table of contents

How to Use

Just paste the following URL in your profile readme and you are good to go.

Pass your username in the URL

[![Ashutosh's github activity graph](https://github-readme-activity-graph.ashutosh-dwivedi0710.workers.dev/graph?username=Ashutosh00710)](https://github.com/ashutosh00710/github-readme-activity-graph)

The public instance is shared by everyone and can hit GitHub's API rate limit. For a graph that always loads, deploy your own instance; it's free.

Use themes

username=ashutosh00710&theme=theme_name

[![Ashutosh's github activity graph](https://github-readme-activity-graph.ashutosh-dwivedi0710.workers.dev/graph?username=Ashutosh00710&theme=dracula)](https://github.com/ashutosh00710/github-readme-activity-graph)

Manual Customization is also available

Available Themes

Name Preview
Default (cotton candy) graph
react graph
react-dark graph
github graph
github-compact graph
xcode graph
rogue graph
merko graph
vue graph
tokyo-night graph
high-contrast graph

For more themes click here

Customization

Customize the appearance of your Activity Graph however you want with URL params.

Common Options

Arguments Description Type of Value
bg_color card's background color hex code (without #)
border_color card's border color hex code (without #)
color graph card's text color hex code (without #)
title_color graph card's title color hex code (without #)
line graph's line color hex code (without #)
point color of points on line graph hex code (without #)
area_color color of the area under the graph hex code (without #)
area shows area under the graph boolean (default: false)
hide_border makes the border of the graph transparent boolean (default: false)
hide_title sets the title to an empty string boolean (default: false)
custom_title set the title to any string string
theme name of available themes string
radius border radius of graph number (0-16 inclusive)
height height of the graph number (200-600 inclusive)
days number of to days display on graph number between (1 - 90) [Recommended below 40]
from date from which the graph starts format YYYY-MM-DD
to date where the graph will end format YYYY-MM-DD
grid show grid boolean (default: true)

⚠ For custom_title please make sure that you are using %20 for spaces

Example:

custom_title=This%20is%20a%20title

[![Ashutosh's github activity graph](https://github-readme-activity-graph.ashutosh-dwivedi0710.workers.dev/graph?username=ashutosh00710&custom_title=This%20is%20a%20title&hide_border=true)](https://github.com/ashutosh00710/github-readme-activity-graph)

Example:

[![Ashutosh's github activity graph](https://github-readme-activity-graph.ashutosh-dwivedi0710.workers.dev/graph?username=ashutosh00710&bg_color=fffff0&color=708090&line=24292e&point=24292e&area=true&border_color=ff0000)](https://github.com/ashutosh00710/github-readme-activity-graph)

Deploy on your own Cloudflare Worker

This is how the public instance runs, and Cloudflare's free plan is enough for personal use.

Step-by-step instructions for deploying to Cloudflare Workers

From the Cloudflare dashboard

  1. Fork this repo.
  2. In the Cloudflare dashboard, go to Workers & Pages β†’ Create β†’ Import a repository and pick your fork.
  3. Set the Worker name to github-readme-activity-graph (it must match name in wrangler.jsonc) and use:
    • Build command: leave empty
    • Deploy command: npx wrangler deploy
    • Preview command: npx wrangler versions upload
  4. Create a personal access token (PAT) here. Enable repo access if you want private contributions counted.
  5. In the Worker's Settings β†’ Variables and Secrets, add a Secret named TOKEN with your PAT, then redeploy.
  6. Optional but recommended: add a custom domain to the Worker. Graphs are cached at Cloudflare's edge only on custom domains, not on *.workers.dev.

From the command line

npm install
npx wrangler login
npx wrangler secret put TOKEN
npx wrangler deploy

To try it locally first, put TOKEN=<your PAT> in a .env file and run npm run cf:dev.

Finally

Add the following to your profile README:

![Github Activity Graph](https://<your-worker>.<your-subdomain>.workers.dev/graph?username=<username>)

Deploy on your own Replit instance

Step-by-step instructions for deploying to Replit (from UI)

Follow the steps

  1. Sign in to Replit or create a new account at https://replit.com
  2. Click the Deploy button below
Run on Repl.it
  1. On the page that comes up, choose language as Node.js and then click Import from GitHub Button

    Replit

  2. Visit this link to create a new Personal Access Token

  3. Scroll to the bottom and click "Generate token"

  4. Wait clone done and add Secrets with your Github token

    Secrets

  5. Click the green RUN button on top, the console will run and at last the url will shows on the right

  6. Now just add the following to your profile readme and you're good to go

![Github Activity Graph](<url from step 5>/graph?username=<username>)

Deploy on your own Vercel instance

Step-by-step instructions for deploying to Vercel (from UI)

First Method

  1. Go to vercel.com.
  2. Click on Log in. image
  3. Sign in with GitHub by pressing Continue with GitHub. image
  4. Sign in to GitHub and allow access to all repositories if prompted.
  5. Fork this repo.
  6. Go back to your Vercel dashboard.
  7. To import a project, click the Add New... button and select the Project option. image
  8. Click the Continue with GitHub button, search for the required Git Repository and import it by clicking the Import button. image
  9. Create a personal access token (PAT) here and enable the repo permissions (this allows access to see private repo stats). image
  10. Add the PAT as an environment variable named TOKEN. image
  11. Click deploy, and you're good to go. See your domains to use the API!

Second Method

Alternatively, click the button below and follow the instructions.

Deploy to Vercel

After the deployment is complete:

  1. Click the Continue to Dashboard button image
  2. In the Settings tab, click on Environment Variables and follow steps 9. and 10. of First Method. image
  3. Go to Deployments tab and redeploy the project. image

Finally

Now just add the following to your profile readme and you're good to go.

![Github Activity Graph](<{your_own_domain_name}.vercel.app>/graph?username=<username>)

Contributing

Please read through our contributing guidelines. Directions are included for opening issues, coding standards, and notes on development.

Core Team πŸ’»


Ashutosh Dwivedi

πŸ“† πŸ’» πŸ“– πŸ€” ⚠

Kshitij Srivastava

πŸ“† πŸ’» πŸ“– 🎨

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Upamanyu Das

πŸ“–

Jonah Lawrence

πŸ’» πŸ“–

Milind Modi

πŸ“–

Vaibhav

πŸ’» πŸ“–

Jacob Philpott

πŸ’» πŸ“–

Sonu Kumar

🎨 πŸ“–

Mykola Symon

πŸ’»

Sreyan Ghosh

🎨

Anant Mishra

🎨

Skyler

🎨

Iryna Mykoliuk

🎨

Dalpat Rathore

🎨 πŸ’»

Dmitriy Fishman

πŸ“–

MagicLike

🎨 πŸ’»

OnkarRuikar

πŸ’»

valetzx

πŸ“–

tranthaituananh

🎨 πŸ“–

polekstulod

πŸ“–

jmloudis

πŸ’»

fabianocouto

πŸ’» πŸ“–

Apoorv

🎨

This project follows the all-contributors specification. Contributions of any kind welcome!

Resources Used to build this project

Purpose Library Name Link
Graph Construction (layout and styling based on) CHARTIST.JS https://github.com/gionkunz/chartist-js


Star History

Star History Chart

Made with ❀ and TypeScript

About

A dynamically generated activity graph to show your GitHub activities of last 31 days.

Topics

Resources

Code of conduct

Contributing

Stars

2.4k stars

Watchers

13 watching

Forks

Sponsor this project

Contributors

Languages