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.