README Generator

How to Add an Activity Graph to Your GitHub Profile README

The GitHub README Activity Graph renders a full-width bar chart of your contribution history over the past 31 days with a line overlay showing activity trends. Unlike the standard contribution calendar (which requires visiting your profile page directly), the activity graph embeds as a dramatic wide visual that immediately communicates how consistently you commit code. This guide covers the ashutosh00710/github-readme-activity-graph project, which generates the graph via a simple image URL — no GitHub Actions, no setup required.

Quick Setup Steps

  1. 1

    Step 1: Open your GitHub profile repository and edit README.md.

  2. 2

    Step 2: Add the activity graph image tag with your username and preferred theme.

  3. 3

    Step 3: Optionally add area=true and hide_border=true for a cleaner look.

  4. 4

    Step 4: Wrap in a <div align='center'> tag to center the wide graph in your README.

  5. 5

    Step 5: Commit and push. Visit your profile to verify the 31-day contribution graph renders.

What Is the GitHub Activity Graph?

The github-readme-activity-graph project generates a wide SVG chart showing your GitHub contributions over the past month. The chart type is a combination of a bar graph (one bar per day) and a line graph (trend line connecting the activity peaks), giving a more dramatic visual representation than the default contribution calendar dots.

The chart spans the full width of the README on most screen sizes, making it a strong visual centerpiece for profiles with consistent daily activity. For developers who code in bursts rather than daily, the graph may show prominent gaps — in that case, the streak stats card or GitHub metrics may be a better choice.

How to Add the Activity Graph

Add this to your README, replacing YOUR_USERNAME:

[![Activity Graph](https://github-readme-activity-graph.vercel.app/graph?username=YOUR_USERNAME&theme=tokyo-night)](https://github.com/ashutosh00710/github-readme-activity-graph)

Note that the theme parameter uses tokyo-night (with a hyphen) rather than the tokyonight format used by github-readme-stats — these are different theming systems.

For a card with a custom height and hidden border:

[![Activity Graph](https://github-readme-activity-graph.vercel.app/graph?username=YOUR_USERNAME&theme=tokyo-night&hide_border=true&area=true)](https://github.com/ashutosh00710/github-readme-activity-graph)

The area=true parameter fills the area under the line graph, creating a more dramatic visual effect.

Customizing the Activity Graph

The activity graph supports extensive customization:

  • theme: Available themes include tokyo-night, github, github-compact, dracula, nord, gruvbox, xcode, rogue, onedark, solarized-dark, solarized-light, minimal, vue, react, react-dark, angular-dark
  • color: Custom line color (hex without #)
  • line: Custom line color
  • point: Custom data point color
  • bg_color: Background color (hex without #)
  • area=true: Fill area under line graph
  • hide_border=true: Remove the card border
  • area_color: Custom fill color for the area under the line
  • custom_title: Override the default 'Contribution Graph' title text
  • height: Card height in pixels (default 300)

For a minimal look: ?theme=minimal&hide_border=true&area=true

Troubleshooting the Activity Graph

If the graph shows no activity even when you have recent commits, check that your contributions are being counted publicly. GitHub can take up to 24 hours to reflect new contribution data in the public API.

If the image appears but shows an error message instead of a graph, the Vercel endpoint may be experiencing temporary issues. The project's GitHub repository at ashutosh00710/github-readme-activity-graph has self-hosting instructions if uptime is critical.

If the graph appears too narrow on mobile screens, note that the activity graph is designed as a wide desktop-first widget. Wrapping it in a <div align='center'> can help center it on mobile, but it will always render at its full SVG width and scale down on smaller screens.

Frequently Asked Questions

How do I add an activity graph to my GitHub README?

Add this to your README: `[![Activity Graph](https://github-readme-activity-graph.vercel.app/graph?username=YOUR_USERNAME&theme=tokyo-night)](https://github.com/ashutosh00710/github-readme-activity-graph)`. Replace YOUR_USERNAME with your GitHub handle. The graph renders immediately from the URL — no setup needed.

Is the GitHub README activity graph free?

Yes. The ashutosh00710/github-readme-activity-graph project is open source and the hosted service on Vercel is free. No API key, account, or GitHub Action is needed. Self-hosting instructions are in the repository for users who need guaranteed uptime.

Why is my activity graph not showing contributions?

GitHub contribution data can take up to 24 hours to update in the API. Also verify your username is correct in the URL. If contributions are in private repositories, they may not appear unless private contributions are enabled in your GitHub profile settings.

Does the activity graph show private repository contributions?

The graph shows contributions from your public GitHub activity by default. Private repository contributions appear only if you have enabled 'Include private contributions on my profile' in your GitHub profile settings under Contribution settings.

From Our Blog

Generate Your GitHub Profile README

Generate a GitHub profile README featuring Activity Graph with AI

Try It Free — No Sign Up