No description, website, or topics provided.
Ruby CSS Gherkin HTML Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.capistrano
app
config
db
doc
features
lib
log
public
script
test
vendor
.coveralls.yml
.env.example
.gitignore
.powrc
.travis.yml
Capfile
Gemfile
Gemfile.lock
LICENSE.md
Procfile
README.md
Rakefile
config.ru
dump.rdb
newrelic.yml

README.md

Build Status Coverage Status License

UK Postcodes

This is the next generation version of http://www.uk-postcodes.com. 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 Postgres.app, otherwise follow the instructions at http://postgis.net/install/. 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 git@github.com:theodi/uk-postcodes.git

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.