GitChrono

Embed a live GitHub repo history on your own site.

Who this is for

If you write about open source, maintain project docs, or run a developer blog, you can drop a live commit-activity visualization of any public GitHub repository straight into a page. Readers see how the project has evolved — right there, without leaving your site.

It's a native Web Component rendered in its own Shadow DOM, so its styles can't collide with your site's CSS and your CSS can't break it. No iframe, no build step, no tracking, and no token — it calls the public GitHub REST API directly from the reader's browser.

How to embed it

Paste this where you want the visualization to appear:

<style>gitchrono-widget:not(:defined){display:block;min-height:360px}</style>
<script src="https://gitchrono.x1.kumavolt.dev/widget.js" async></script>
<gitchrono-widget repo="facebook/react"></gitchrono-widget>

The <script> tag can go once anywhere on the page (e.g. before </body>); add one <gitchrono-widget> tag, with a repo="owner/repo" attribute, for each visualization you want. The one-line <style> reserves the widget's space while it loads, so readers on a slow connection get a stable placeholder instead of a jump — keep it if you copy the snippet.

Optional attributes

Attribute What it does
repo Required. The public repository to visualize, e.g. repo="torvalds/linux".
count How many recent commits to analyse: 100 (default), 200, or 300.
<gitchrono-widget repo="rust-lang/rust" count="300"></gitchrono-widget>

Live demo

This is the actual widget, running from the same widget.js the snippet above loads:

Good to know

Anonymous GitHub API access is limited to 60 requests per hour per IP address, so the widget analyses a recent window of commits (100–300) rather than a repository's entire history — and if a reader's network hits that limit, the widget says so honestly rather than showing a broken chart. Nothing the reader does leaves their browser except the repository name, sent to GitHub to fetch its public data. The widget keeps a small "See full history on GitChrono" link back to this project — please leave it in place.