WITW

🚧 This app is still in alpha development and we don't recommend using it yet.

Development server

The code for the server is located in the backend directory.

1. Install dependencies

1. Install Postgres.app and follow the instructions to add it to your path.

2. Set a virtualenv (optional)

3. Install the OS & pip dependencies.

# On MacOS with brew
brew install gdal libgeoip

# On Ubuntu
sudo add-apt-repository ppa:ubuntugis/ppa
sudo apt-get update
sudo apt-get install libgeoip-dev libgdal-dev gdal-bin
sudo apt-get install postgresql-12-postgis-3

# On everything
pip install -r requirements-dev.txt
pip install -r requirements.txt

Running on M1 To run successfully on M1, set the following env vars

export GDAL_LIBRARY_PATH=/opt/homebrew/lib/libgdal.dylib
export GEOS_LIBRARY_PATH=/opt/homebrew/lib/libgeos_c.dylib

2. Create database and start backend

psql
CREATE DATABASE whereintheworld;
CREATE USER whereintheworld WITH PASSWORD 'whereintheworld';
ALTER ROLE whereintheworld SUPERUSER;

**Migrate the database

python manage.py migrate
python manage.py cities --import=all

3. Get Google Oauth configs

https://console.cloud.google.com/apis/credentials

3. Start the app

The code for the frontend is located in the src directory. You can start the entire app (frontend & backend) as follows:

yarn
./bin/start

The server is now running at http://localhost:8000/. Warning: Don't visit localhost:3000 as the raw frontend will not work as expected.