A widget for displaying GitHub activity for a user.
JavaScript CSS
Latest commit 2f0724b Mar 6, 2016 @caseyscarborough Merge pull request #23 from NateShoffner/single-line-consistency
Made single-line activity styles consistent

README.md

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.

A sample image of the activity stream is shown below:

Dependencies

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:

<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/octicons/2.0.2/octicons.min.css">
<link rel="stylesheet" href="github-activity-0.1.4.min.css">

<script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/mustache.js/0.7.2/mustache.min.js"></script>
<script type="text/javascript" src="github-activity-0.1.4.min.js"></script>

The files can be downloaded from the releases page.

If you'd like to build the files yourself:

# Ensure you have grunt and bower installed
npm install bower
npm install grunt-cli

# Clone the repository
git clone https://github.com/caseyscarborough/github-activity.git
cd github-activity

# Install dependencies
bower install

# Build dist
grunt

Usage

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:

GitHubActivity.feed({
    username: "your-username",
    repository: "your-repo", // optional
    selector: "#feed",
    limit: 20 // optional
});

Credits

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