No description, website, or topics provided.
Ruby CSS Gherkin HTML Other
Latest commit 5c60f35 Sep 25, 2015 1 @pezholio pezholio Heroku
Failed to load latest commit information.
app Add the Northern Ireland bit back in Oct 3, 2014
config Heroku Sep 25, 2015
db Tweak boundary model Mar 11, 2014
doc First commit Nov 13, 2013
features Update tests Dec 18, 2014
lib Improve import script Mar 11, 2014
log First commit Nov 13, 2013
public First commit Nov 13, 2013
script Add basic tests Nov 16, 2013
test First commit Nov 13, 2013
vendor First commit Nov 13, 2013
.coveralls.yml Add coveralls Jan 10, 2014
.env.example Add .env Jan 9, 2014
.gitignore Add .env Jan 9, 2014
.powrc First commit Nov 13, 2013
.travis.yml Cache bundles Mar 13, 2014
Capfile Capistrano! Dec 27, 2013
Gemfile Heroku Sep 25, 2015
Gemfile.lock Heroku Sep 25, 2015 Add explicit License May 15, 2014
Procfile Foreman and Thin sitting in a tree Dec 27, 2013 Improve docs Apr 14, 2014
Rakefile First commit Nov 13, 2013 First commit Nov 13, 2013
dump.rdb Fix radius and legacy redirects Jan 8, 2014
newrelic.yml Add New Relic stuff Dec 31, 2013

Build Status Coverage Status License

UK Postcodes

This is the next generation version of The functionality is largely unchanged, but improvements include:

  • Better codebase (bye bye PHP)
  • PostGIS backend
  • (Hopefully) better support
  • New design
  • Easy setup for local installs

Running a local version

I've included all the necessary data in this repo (which I will keep updated). To get this up and running locally (I'm assuming you have Ruby installed).

Install PostgreSQL and PostGIS

If you're running a Mac, the easiest way to install Postgres and PostGIS is to install, otherwise follow the instructions at Then do the following:

psql -c 'CREATE USER root with SUPERUSER;' -U postgres
psql -c 'CREATE DATABASE uk_postcodes_development;' -U postgres
psql -d uk_postcodes_development -c 'CREATE SCHEMA postgis; CREATE EXTENSION postgis WITH SCHEMA postgis;' -U postgres

Clone the repo

git clone

Run bundler

bundle install

Run migrations

rake db:migrate

Import the data

rake import:all

(This will take a couple of hours, so go outside and play, or something)

Run the app

rails s

Obviously if you're running this in production, you may need to do some other steps, but these steps should be all you need to get it running locally.