This app is a showcase of Github projects for an organization or a user, all in Javascript.
It uses AuraJS and an aura-github extension that allows our Widgets to talk directly to Github's API, and 2 Aura widgets :
- user to load and display a user's profile. (In our case, hull's organization)
- repos to load and display a list of repos.
If you want to know more how it was done, read the blog post.
-
First, clone this repository (or fork it directly on Github) :
git clone git://github.com/hull/hull.github.io.git
-
Create a repository named
you.github.io
, whereyou
is your username (If you have fork the repository, don't forget to rename it!) -
Whitelist your domain on your github applications settings https://github.com/settings/applications
Click on Register a new application
Fill Main URL and Callback URL with your github homepage url. (i.e.
http://you.github.io
) -
Configure
index.html
with the correct settings.If you are an organization:
<header data-aura-widget="user" data-aura-org="hull"></header> <ul data-aura-widget="repos" data-aura-org="hull"></ul>
else you are a simple user:
<header data-aura-widget="user" data-aura-user="victa"></header> <ul data-aura-widget="repos" data-aura-user="victa"></ul>
-
git push
to your github page repository and you’re done!
Install node.js (Only used for developing the app locally, not needed for deployment)
Install grunt-cli as a global module.
[sudo] npm install grunt-cli -g
then install grunt and it's modules in the project's folder.
cd hull.github.io
npm install
Start grunt
grunt
Open in your browser
open http://localhost:3010
style
: Optional, could be small or complete depending on what do you want to show.
<ul data-aura-widget="repos" data-aura-style="complete" data-aura-user="victa"></ul>
Here are a few ideas for further improvement :
- Add statistics widgets
- Add more details about an user, an organization, a repository…
- ...
Feel free to fork the project and add your own widget.