Skip to content
This repository has been archived by the owner. It is now read-only.
Oversee the freshness an organization's public GitHub repos
JavaScript CSS HTML
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
.bowerrc
.firebaserc
.gitignore
LICENSE
README.md
bower.json
firebase.json
gulpfile.js
package.json
rules.json

README.md

THIS PROJECT IS ARCHIVED. IT IS NOT UNDER ACTIVE DEVELOPMENT. FEEL FREE TO FORK IT!

Seer GitHub Seer Logo - Green Eye

Seer is an open-source dashboard to help you manage your GitHub organization's public repositories. The dashboard uses the GitHub API to retrieve all open issues and pull requests for your organization's public repos. It assigns each repo a color depending on how "fresh" it is; that is, how many open issues and pull requests are there and how long has it been since they have been updated.

Seer can give you a good idea of what repos are becoming unmaintainable within your organization. It also lets you assign a primary and secondary owner to your repos so everyone knows who is responsible for what. Seer will help you get a high level view of your repos and give them the love they need.

Demo

Check out Firebase Seer to see the dashboard in action for the Firebase organization.

Usage

There are two ways to view your own organization's dashboard. First, you could just tack on ?org=<your-organization> to the Firebase Seer URL. For example, here is the link to Facebook Seer.

You can also host your own version of Seer for your organization by cloning this repo. All you need to do is replace the default organization username and public (no permissions) GitHub access token in reposContainer.js on this line with your organization's username and your public GitHub access token.

If you need a place to host your organization's Seer, check out Firebase Hosting. You'll have your custom Seer up and running in just a couple minutes.

Security

Only people who belong to your organization can view and edit ownership data about your repos. Unlike the repo data (i.e. open issues, pull requests, etc.) which is all public, ownership data is stored securely in Firebase and only visible to your coworkers. In addition, you can only assign ownership of a repo to someone if they belong to your organization.

Contributing

If you'd like to contribute to Seer, you'll need to run the following commands to get your environment set up:

$ git clone https://github.com/jwngr/seer.git
$ cd seer               # go to the seer directory
$ npm install -g gulp   # globally install gulp task runner
$ npm install -g bower  # globally install Bower package manager
$ npm install           # install local npm build dependencies
$ bower install         # install local JavaScript dependencies
$ gulp                  # build the distribution files

gulp watch will watch for changes in the /src/ directory and compile, lint, concatenate, minify, and copy the source files when a change occurs. The output files are written to the /dist/ directory.

To view Seer locally, you can use Python to spin up a local server:

$ python -m SimpleHTTPServer

Then, navigate to http://localhost:8000/dist/index.html to view Seer.

You can’t perform that action at this time.