Skip to content


Folders and files

Last commit message
Last commit date

Latest commit


Repository files navigation

GitHub Activity Stream Widget

This is a small Javascript plugin that creates a stream of your recent GitHub activity. It displays the user's name, username, photo, and a list of each individual activity type. Click here for a demo.

Light Theme

Dark Theme


The two dependencies for the plugin are the Mustache templating library and Octicons (if you want the icons to show). You can include these along with the scripts for the plugin in the head of your page with the following HTML:

Using CDN

<link rel="stylesheet" href="">
<link rel="stylesheet" href="">

<script type="text/javascript" src=""></script>
<script type="text/javascript" src=""></script>

<!-- if using dark theme add this in addition to the main CSS file -->
<link rel="stylesheet" href="">

Using npm

Install the library:

npm install --save github-activity-feed

Add the files to your webpage:

<link rel="stylesheet" href="node_modules/octicons/build/font/octicons.css">
<link rel="stylesheet" href="node_modules/github-activity-feed/dist/github-activity.min.css">

<script type="text/javascript" src="node_modules/mustache/mustache.min.js"></script>
<script type="text/javascript" src="node_modules/github-activity-feed/dist/github-activity.min.js"></script>

<!-- if using dark theme add this in addition to the main CSS file -->
<link rel="stylesheet" href="node_modules/github-activity-feed/dist/github-activity.dark.min.css">


If you'd like to build the files yourself:

# Install dependencies
npm install

# Build dist
npx grunt


To use the library, begin by creating a new div with an id in the body of your page:

<div id="feed"></div>

Then call the feed method via Javascript:

  username: "your-username",
  repository: "your-repo", // optional
  selector: "#feed",
  limit: 20, // optional


Fork and Enjoy

Please feel free to contribute to the application by following the steps below:

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request