Need help with GithubFinder?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

125 Stars 10 Forks 128 Commits 9 Opened issues


Github Repository Finder, now powered by GitHub API and Heroku

Services available


Need anything else?

Contributors list

# 457,875
127 commits

Github Finder

GithubFinder is a fast Github repository browser. The browser is inspired after Mac OSX Finder.
Github File Finder

To see the finder in action, go to


Github File Greasemonkey Button

  • Bookmarklet: If you don't have GreaseMonkey/Greasekit installed, you can drag the bookmarklet to your address bar. The bookmarklet will open a new GHFinder window of the currently viewed repository.
  • Switch between repos and branches with ease.
  • Keyboard navigation support with arrow keys.
  • Text files can be previewed inline with syntax highlighting (support Ruby, JavaScript, CSS, and HTML) with Textmate-like Twilight theme.
  • Files can be diff-ed directly between commits (diff is done by difflib).
  • 100% javascript with full cross-domain support. For functionalities that Github API, the app relies on a proxy running on Heroku ( to get the data.
  • flexible framework to customize and extend the existing functionalities.
  • GitHub JS API wrapper (/javascripts/gh.js).

10K App

Github Finder is built as a contest entry into the 10K Apart contest ( I wanted to develop a real useful app instead of a mindless canvas drawing (which is cool, but not that useful), and I always wanted to browse Github repositories easier and faster.


Since the app needs to be under 10,240 bytes, it needs special optimization to achieve this size. The unminifed, uncompressed JS is about 30+ KB, all compressed down to 8.5KB or so.

To build the app, run the provided ./build script to automatically bundle up everything into the ./app folder

For an IE9 build, run ./ie9build

App Bootstrap

The minified app is working as follow:

  • bootstrap.js loads code from png and eval
  • javascripts/app.js file is executed (this file is appended at the end of the files list)


The code is somewhat modularized with a main class (F, defined in /javascripts/f.js) for the Finder itself. This class can be extended to add more functionalities through various plugins. Currently the plugins are

  • Diff: allowing user to diff 2 different files from Github.
  • Code Highlighter: currently supports Ruby, JavaScript, CSS, and HTML.
  • Keyboard navigation: user can use the arrow keys to navigate.
  • ResizablePanel: enable the panels to be resizeable.
  • GithubReadme: automatically grab the Readme files from github. Currently supported Markdown (.md, .markdown), Textile (.textile) readme files (Github only renders these files automatically)
  • Bookmarklet: lets user create a bookmark to quickly access GithubFinder
  • Greasemonk/Greasekit userscript: extend Github's interface with a button linking to Github Finder to allow quick access.

Combined with the build script, this architecture is flexible enough to enable or disable certain components to achieve the right size/features.

The Application also relies on JSONP to grab the data from Github. The provided proxy.php script can handle both normal Ajax Requests and JSONP requests. However, the proxy now is done by a small Sinatra app running on Heroku at The source for this app is at


Github Finder is possible by leveraging these tools:


  • My name is Alex Le. I'm an entrepreneur and I build web applications. I'm a single founder bootstrapping Marrily (, an online wedding planner. Come check it out! My blog is at

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.