readme/activity-graph

GitHub Readme Activity Graph

Your contribution graph,
ready for your README.

Type a GitHub username, style the graph, and copy one line of Markdown. The image stays up to date by itself.

Preview Sample data

Embed in your README

Generate a graph to get your embed code.

The link carries every setting, so pasting it is all you need. GitHub caches README images for a few hours.

API

Every graph is a plain SVG served from GET /api/graph. Unknown or invalid parameters fall back to safe defaults.

GET /api/graph?username=octocat&type=line

SVG image for READMEs. type is heatmap (default), line or combo; /api/graph/octocat works too.

range=7d · 30d · 90d · 6m · 1y · custom

With range=custom, pass from and to (YYYY-MM-DD, up to one year). Raw data: GET /api/contributions.

theme · background · text · border · empty · color1–4

Themes: light, dark, dim, lime, ocean, ember, custom. Line graph: lineColor, pointColor, areaColor, gridColor. Hex without #.

width · height · cellSize · cellGap · radius · padding

Line graph: lineWidth, smoothing, pointRadius, areaOpacity, gridStyle, showGridX, showValues, …