Land Use Demonstrator Web App
Web app for visualisation of modelling and results from the Land Use Demonstrator project. See:
- The Geospatial Commission's blog post about the project
- A page on the Alan Turing Institute's intranet, Mathison, about the project.
The frontend (Svelte/TypeScript) is in the web directory; the backend (Python) is in the demoland_engine submodule.
View online
https://Urban-Analytics-Technology-Platform.github.io/demoland-web
The dev branch can be previewed at https://Urban-Analytics-Technology-Platform.github.io/demoland-web/dev.
(This is not guaranteed to always be functional!)
Running locally
The easiest way is probably using Docker.
Make sure to include the --recursive flag when cloning; this ensures that the backend submodule is properly initialised.
git clone --recursive git@github.com:Urban-Analytics-Technology-Platform/demoland-web.git
cd demoland-web
make docker
Then, navigate to http://localhost:5173.
Local development
First, clone the repository as before:
git clone --recursive git@github.com:Urban-Analytics-Technology-Platform/demoland-web.git
cd demoland-web
For the frontend:
make fe-deps # First time only
make fe
Vite (the build tool this app uses) defaults to port 5173, so the web app is again accessible via http://localhost:5173. Vite's hot module replacement feature also allows you to instantly view changes in the web browser when code is modified, which is a really nice touch.
Most of the app works without the backend.
However, to create your own scenarios and calculate their impacts, you will need to launch the backend as well.
In a new terminal window, cd into the top-level repository and:
make be-deps # First time only
make be
Note that this exposes the backend API on port 5174; this is where the frontend expects to find it.
Specifically, the frontend looks for the /api/ endpoint, which Vite reverse-proxies to port 5174.
When running under Docker, the backend is not exposed to the host computer (it is only exposed to other containers). Running this locally is the only way to directly test the backend.
Finally, to run both frontend and backend concurrently, do:
make fe-deps # First time only
make be-deps # First time only
make local
Spinning up a new, customised copy of DemoLand
See web/src/data/README.md.
Related repositories
This web app is powered by two other repositories:
- demoland-project contains the modelling work which is responsible for the predicted indicator values, as well as a book discussing the project methodology and developer notes for the web app.
- demoland-engine is a self-contained package which hosts the final trained models, as well as a REST API which is used for the custom scenario prediction backend.