A dynamic web based online system for visualizing georeferenced data at different geographic levels.
This repository contains the frontend code for the GeoManager package. The GeoManager is the backend system that helps to manage and organize datasets visualized by this mapviewer.
The GeoMapViewer web app is built with Nextjs, React and Redux.
The app is developed to be deployed alongside the GeoManager on a single server using Docker
The GeoManager is a Wagtail based application that should be installed in a Wagtail Project. The Geomanager serves as the backend system for this map viewer application. For a complete setup, you need to have both components installed, up and running.
This means you need to have a Wagtail project setup, with GeoManager package installed.
Below are general steps to get your started:
- Have a Wagtail project up and running. If starting from scratch, you can use the sample project at https://github.com/wmo-raf/geomanager/tree/main/sandbox to get you started.
- Install the GeoManager package in your wagtail project. Follow the instructions at GeoManager
- Follow the instructions below to install and run the web app
Clone the repo:
git clone https://github.com/wmo-raf/geomapviewer.git
Installing dependencies:
yarn
Copy the .env.sample
to .env
, and start the server:
yarn dev
The app should now be accessible on http://0.0.0.0:3000.
The following are the environmental variables that you can update in your .env
file
- CMS_API=
- ANALYTICS_PROPERTY_ID=
- GOOGLE_CUSTOM_SEARCH_CX=
- GOOGLE_SEARCH_API_KEY=
- BITLY_TOKEN=
The CMS_API
is the url to the Wagtail project instance described above (with Geomanager installed). This should be in form http://<ip_or_domain>/api
without trailing slash. For example http://127.0.0.1:8000/api
The application is developed to be deployed together with the Wagtail Geomanager component. You can deploy this together using docker-compose
with nginx
as a reverse proxy.
TODO