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
Step 1: Open your GitHub profile repository and edit README.md.
- 2
Step 2: Add the activity graph image tag with your username and preferred theme.
- 3
Step 3: Optionally add area=true and hide_border=true for a cleaner look.
- 4
Step 4: Wrap in a <div align='center'> tag to center the wide graph in your README.
- 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:
[](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:
[](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 includetokyo-night,github,github-compact,dracula,nord,gruvbox,xcode,rogue,onedark,solarized-dark,solarized-light,minimal,vue,react,react-dark,angular-darkcolor: Custom line color (hex without#)line: Custom line colorpoint: Custom data point colorbg_color: Background color (hex without#)area=true: Fill area under line graphhide_border=true: Remove the card borderarea_color: Custom fill color for the area under the linecustom_title: Override the default 'Contribution Graph' title textheight: 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: `[](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
- Complete Guide to GitHub Badges for Your README
Learn how to add shields.io badges, GitHub stats cards, and tool badges to your GitHub profile README. Includes ready-to-use code for 50+ popular technologies.
- Best GitHub README Widgets and Tools: The Complete 2026 List
A curated list of the best GitHub profile README widgets — from snake animations to Spotify players, stats cards to 3D contribution graphs. Includes setup instructions for each.
- How to Add GitHub Stats Cards to Your README (2026 Guide)
Step-by-step guide to adding GitHub stats cards, language cards, streak stats, and WakaTime cards to your GitHub profile README using github-readme-stats.
Generate Your GitHub Profile README
Generate a GitHub profile README featuring Activity Graph with AI
Try It Free — No Sign UpMore Widget Guides
How to Add Spotify Now Playing
Step-by-step guide to adding Spotify Now Playing to your GitHub README
How to Add WakaTime Coding Stats
Step-by-step guide to adding WakaTime Coding Stats to your GitHub README
How to Add Snake Contribution Animation
Step-by-step guide to adding Snake Contribution Animation to your GitHub README
How to Add Profile Views Counter
Step-by-step guide to adding Profile Views Counter to your GitHub README
How to Add Typing SVG Animation
Step-by-step guide to adding Typing SVG Animation to your GitHub README
How to Add GitHub Streak Stats
Step-by-step guide to adding GitHub Streak Stats to your GitHub README