uApp Explorer, the unofficial Ubuntu Touch Appstore

uApp Explorer

uApp Explorer

Codeship Status Github Stars Github Issues License Gratipay

Browse and search apps from the Ubuntu Touch appstore -

uApp Explorer uses publically available data from the Ubuntu Touch click appstore api, It is maintained by Brian Douglass and is not endorsed by or affiliated with Ubuntu or Canonical. Ubuntu and Canonical are registered trademarks of Canonical Ltd.


  • Install vagrant
  • Install the docker compose vagrant plugin:
    • Run: vagrant plugin install vagrant-docker-compose
  • Install NPM dependencies:
    • Run: npm install
    • Run: cd www && npm install
  • Install gulp and bower:
    • Run npm install -g gulp bower
  • Start vagrant:
    • Run: vagrant up
  • Run the spider (Inside the vagrant VM):
    • Run: spider
  • Compile the frontend:
    • Run: cd www && gulp watch
  • Attach to the docker container (if needed - from inside the vagrant VM):
    • Run: attach
  • Update your system’s hosts file:
    • Add
  • Visit the site:
    • In your browser go to:
  • Profit!

Using the Spider

Run this commands from inside the vagrant VM.

  • Fetch all packages - spider
  • Fetch only updated/missing packages - spider update
  • Fetch departments/categories - spider department
  • Fetch reviews - spider review
  • Fetch reviews for a single package - spider review
  • Fetch a single package - spider


uApp Explorer is setup to deploy to Heroku via Codeship. After code is pushed to the Github repo Codeship runs the following to deploy:

#Switch to node v5
nvm install 5
nvm use 5

#Install dependencies
npm install

#Lint the code
gulp lint

#Deploy to the app server
git config --global "$EMAIL"
git config --global "$NAME"
echo yes | gulp deploy-app

#Deploy to the spider server
echo yes | gulp deploy-spider

With the following env vars:

  • UAPPEXPLORER_APP_GIT - Git uri for the deploy repo (app/api)
  • UAPPEXPLORER_SPIDER_GIT - Git uri for the deploy repo (spider)
  • EMAIL- Git email, so git doesn’t complain
  • NAME - Git full name


uApp Explorer is currently setup on hobby Heroku dyno. Deployment is done via Codeship. The mongo database is hosted on Mongolab. uApp Explorer uses the Ubuntu Click api to get app data and for parsing app packages. Papertrail is used for logging and Mailhide is used to protect email addresses.

Checkout the stack on Stackshare.


See src/config.js for more info about configuring uApp Explorer.


See package.json, www/package.json and www/bower.json for a list of third party dependencies. A big thank you to all those projects!


The logo is derived from the compass icon from FontAwesome.


Copyright © 2016 Brian Douglass

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 3, as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranties of MERCHANTABILITY, SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see

Related Repositories



uApp Explorer, the unofficial Ubuntu Touch Appstore ...