Skip to content
📊 Embed your GitHub calendar everywhere.
JavaScript HTML CSS
Branch: gh-pages
Clone or download

Latest commit

Latest commit 81a2ada Apr 10, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
dist Rebuild Apr 10, 2020
example ⬆️ 2.1.1 🎉 Apr 10, 2020
lib https Apr 10, 2020
.gitignore Updated docs Dec 17, 2019 Updated docs Apr 10, 2020 Updated docs Apr 10, 2020
LICENSE Updated docs Apr 10, 2020 ⬆️ 2.1.1 🎉 Apr 10, 2020
package-lock.json Updated docs Apr 10, 2020
package.json Updated docs Apr 10, 2020


Version Downloads

Embed your GitHub contributions calendar anywhere.

Everybodywell, haters gonna hate loves GitHub and everybody loves stats. So, why not making the GitHub contributions calendar available for being embeded in your web pages? Now you can. 🎉

☁️ Installation

Check out the dist directory to download the needed files and include them on your page.

If you're using this module in a CommonJS environment, you can install it using npm or yarn and require it:

# Using npm
npm install --save github-calendar

# Using yarn
yarn add github-calendar
<!-- Include the library. -->

<!-- Optionally, include the theme (if you don't want to struggle to write the CSS) -->

<!-- Prepare a container for your calendar. -->
<div class="calendar">
    <!-- Loading stuff -->
    Loading the data just for you.

    GitHubCalendar(".calendar", "your-username");

    // or enable responsive functionality:
    GitHubCalendar(".calendar", "your-username", { responsive: true });

    // Use a proxy
    GitHubCalendar(".calendar", "your-username", { proxy (username) { return fetch(`${username}`).then(r => r.text()) });

Here you can see this example in action.

Get Help

There are few ways to get help:

  1. Please post questions on Stack Overflow. You can open issues with questions, as long you add a link to your Stack Overflow question.
  2. For bug reports and feature requests, open issues. 🐛

📝 Documentation

GitHubCalendar(container, username, options)

Brings the contributions calendar from GitHub (provided username) into your page.


  • String|HTMLElement container: The calendar container (query selector or the element itself).
  • String username: The GitHub username.
  • Object options: An object containing the following fields:
    • summary_text (String): The text that appears under the calendar (defaults to: "Summary of pull requests, issues opened, and commits made by <username>").
    • proxy (Function): A function that receives as argument the username (string) and should return a promise resolving the HTML content of the contributions page. The default is using @Bloggify's APIs.
    • global_stats (Boolean): If false, the global stats (total, longest and current streaks) will not be calculated and displayed. By default this is enabled.
    • responsive (Boolean): If true, the graph is changed to scale with the container. Custom CSS should be applied to the element to scale it appropriately. By default this is disabled.
    • cache (Number) The cache time in seconds.


  • Promise A promise returned by the fetch() call.

😋 How to contribute

Have an idea? Found a bug? See how to contribute.

📜 License

MIT © Bloggify

You can’t perform that action at this time.