By working every day on building the best search engine, we've become obsessed with our own search experience on the websites and mobile applications we use. GitHub is quite big for us, we use their search bar every day but it was not optimal for our needs: so we just re-built Github's search the way we thought it should be and we now share it with the community via this Chrome, Firefox and Safari extensions.
Algolia provides a developer-friendly SaaS API for database search. It enables any website or mobile application to easily provide its end-users with an instant and relevant search. With Algolia's unique find as you type experience, users can find what they're looking for in just a few keystrokes. Feel free to give Algolia a try with our 14-days FREE trial at Algolia.
At Algolia, we're git addicts and love using GitHub to store every single idea or project we work on. We use it both for our private and public repositories (12 API clients, DocSearch, HN Search or various d e m o).
Install it from the stores:
This extension replaces GitHub's search bar and add auto-completion (instant-search & suggestion) capabilities on:
- top public repositories
- last active users
- your private repositories
- default is without Algolia: done locally in your browser using vanilla JS search
- ability to use Algolia (typo-tolerant & relevance improved) through a "Connect with GitHub" (oauth2)
- your issues
- only available if you choose to "Connect with GitHub"
From version 1.6.0, you can now also find GitHub repositories directly from the address bar, by typing aa<space>
.
Address bar autocompletion does not work on Safari.
- We continuously retrieve active repositories and users using GitHub Archive's dataset
- Users and repositories are stored in 2 Algolia indices:
users
andrepositories
- The results are fetched using Algolia's JavaScript API client
- The UI uses Twitter's typeahead.js library to display the auto-completion menu
By default your list of private repositories remains in your local storage. You can allow us to crawl your private repositories with a "Connect with GitHub" (oauth2) action. Your private repositories are then stored securely in our index and only you will be able to search them.
You need to refresh your local list of private repositories:
$ git clone https://github.com/algolia/chrome-awesome-autocomplete.git
# in case you don't have Grunt yet
$ sudo npm install -g grunt-cli
$ cd chrome-awesome-autocomplete
# install dependencies
$ npm install
# generate your private key (required for Chrome)
$ openssl genrsa 2048 | openssl pkcs8 -topk8 -nocrypt > mykey.pem
# build it
$ grunt
When developing, write unit-tests, use dev
Grunt task to check that your JS code passes linting tests and unit-tests.
When ready to try out the extension in the browser, use default Grunt task to build it. In build
directory you'll find develop version of the extension in unpacked-dev
subdirectory (with source maps), and production (uglified) version in unpacked-prod
directory.
The .crx
packed version is created from unpacked-prod
sources.
The .zip
archive is created from build/firefox-unpacked-prod
.
The safariextz
archive is created from Safari.
clean
: cleanbuild
directorytest
: JS-lint and mocha test, single rundev
: continuoustest
loop- default:
clean
,test
, build step (copy all necessary files tobuild
directory, browserify JS sources, prepare production version (using uglify), pack thecrx
andxpi
All publishing instructions can be found in the CONTRIBUTING.md file.