Skip to content


Repository files navigation

Classic (deprecated)

This repository is not maintained anymore. The new GitHub repository is here:

Build Status Stories in Next is an online map to search, find and mark wheelchair-accessible places. Get involved by marking public places like bars, restaurants, cinemas or supermarkets!

This repository is the source code of the old website

Development Environment

A Vagrantfile is bundled for convenience. It is the easiest way to get started testing or developing wheelmap. It will set up the application entirely and configure it for use inside the box. Please note it imports data for Berlin only to say time.

To use this just navigate into the Wheelmap directory and run vagrant up. After it is completed you can enter the box with vagrant ssh. You'll find a current copy of the repository at /vagrant, cd into it then you can start the server with bundle exec rails server, visit it at localhost:3000.

If you use the vagrant box you do not need to worry about the rest of the setup below It is all done for you.

I. Installation


  • Ruby 2.2.2
  • Bundler
  • MySQL 5.6 (< 5.7)
  • ImageMagick
  • PhantomJS
  • Node >= 4.1
  • npm

Before you start, please make sure you have Homebrew for Mac or aptitude for Ubuntu installed.

Install essential software packages:


$ brew install git wget


$ sudo apt-get update
$ sudo apt-get install -y git wget curl zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev libxml2-dev libxslt1-dev libcurl4-openssl-dev python-software-properties libffi-dev libgeos-dev libproj-dev libgdal-dev

Install Ruby 2.2.2:

MacOS / Ubuntu

First, install the Ruby Package Manager of your choice:

Dependent on your choice, please install Ruby with either:

$ rbenv install 2.2.2
$ rbenv rehash
$ rbenv local 2.2.2


$ rvm install 2.2.2
$ rvm use 2.2.2

Note: If you need more infos about how to install rbenv, rvm or Ruby, please take a look at our wiki page.

Install Bundler:

MacOS / Ubuntu

$ gem install bundler

Install MySQL:


$ brew install mysql


$ sudo apt-get update
$ sudo apt-get install -y libmysqlclient-dev mysql-server-5.6

Note: Please make sure to install a mysql-server version that is before v5.7 due to some geometry issues.

Install ImageMagick:


$ brew install imagemagick


$ sudo apt-get install -y imagemagick

Install PhantomJS:

PhantomJS is a testing framework for headless testing.


$ brew install phantomjs   # via Homebrew

$ port install phantomjs   # via MacPorts


$ sudo npm install -g phantomjs-prebuilt

Clone the app from Github:

$ git clone --depth 1
$ cd wheelmap
$ bundle install --path vendor/bundle

II. Getting started

Copy the example secrets.yml:
$ cp config/secrets.sample.yml config/secrets.yml
Copy the example openstreetmap config:
$ cp config/open_street_map.SAMPLE.yml config/open_street_map.yml
Copy the example environment variable config file:
$ cp .env.sample .env
Copy the example database config and edit accordingly:
$ cp config/database.SAMPLE.yml config/database.yml
Edit database.yml to reflect your current database settings.
Now lets create the actual database and prepare minimal data:
$ bundle exec rake db:create:all
Then log into the mysql server and pipe the structure.sql file into the database you want to use, for example:
$ mysql -u root wheelmap_development < db/structure.sql
Run the rake task to seed data:
$ bundle exec rake db:seed
And get some POI data into the database:
$ wget
$ bzcat berlin-latest.osm.bz2 | bundle exec rake osm:import
Install all JavaScript dependencies:


$ brew install node
$ npm install -g npm
$ npm install


$ sudo apt-get install -y nodejs
$ sudo apt-get install -y npm
$ sudo npm install -g npm
Finally startup a local rails server
$ bundle exec rails server

And visit the website in your browser:

III. Documentation

Please also check our wiki, if you need more informations to specific topics and can't find them here, e.g. how to generate a sprite or how to test our app.

IV. Code of Conduct

We refer to the Berlin Code of Conduct and friendly ask all contributors and people involved to comply with it.

V. License

The Wheelmap Software is released under the GNU Affero General Public License v3.0.