🚧 This app is still in alpha development and we don't recommend using it yet.
The code for the server is located in the backend
directory.
Install Postgres.app and follow the instructions to add it to your path.
Set a virtualenv
(optional)
Install the OS & pip dependencies.
# On MacOS with brew
brew install gdal libgeoip
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
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`](./src) directory. You can start the entire app (frontend & backend) as follows:
yarn ./bin/start
The server is now running at [`http://localhost:8000/`](http://localhost:8000/). **Warning:** Don't visit `localhost:3000` as the raw frontend will not work as expected.