Collaborative list making tool written in Node.js
JavaScript Shell
Switch branches/tags
Nothing to show
Clone or download
Latest commit 7de2dbc Jul 17, 2014
Failed to load latest commit information.
.gitignore New installer Jan 21, 2014
.travis.yml organize dir Feb 10, 2013
LICENSE organize dir Feb 10, 2013
Makefile Remove mocha Jul 17, 2014 New installer Jan 21, 2014
config.js.example typo Jan 21, 2014
index.js manifest Jun 2, 2014
install.js New installer Jan 21, 2014
package.json hapi 6.2 Jul 17, 2014

Postmile is a collaborative list making tool built using hapi.js, Node.js, and MongoDB.


Postmile consists of an api server and a web server, both running using Node.js. The two servers can run on the same machine or different machines. The following is based on a shared machine.

$ git clone git://
$ cd postmile
$ npm update
$ cp config.js.example config.js

Edit postmile/config.js with your preferences and configuration.

Enter at least one third-party API credentials (Twitter, Facebook, or Yahoo!) as received from each provider when you registered the application. If asked, the callback URI is your web server configuration entered above with the path '/auth/twitter', '/auth/facebook', or '/auth/yahoo'. For example, if you configured your web server to run on '', port '8000', using the 'http' scheme, and you are using Twitter, your callback URI is

$ node install

Make sure to protect your vault.json file. If an attacker gets hold of them, you're screwed. If you are going to run this in a production environment, you should use TLS (HTTPS) for the web server (otherwise it's cookies and Oz bits are pretty open for attacks). To configure TLS, set the 'process.web.tls' variable in the postmile/config.js file to point to your TLS key and certificate.


To start the API and web servers:

$ node .

Now point your browser at the web server address and start using Postmile. Register with invite code 'public'.


Eran Hammer - Concept and server-side components

Lance Welsh - 'view' web client

Axel Albin-Lax, Josh Kamler, and Bryan Chen - UX/UI design, Snowy web client theme

Emmanuel Crouvisier - 'view' web client CSS/HTML

Chris Carrasco - Original artwork


Postmile is based on the discontinued experimental Yahoo! Sled project initially published at: