MapSwipe Web App

Welcome to MapSwipe4Web. This web application complements the existing mobile app and allows users to contribute to MapSwipe from their browser.

Developing, Building, and Contributing to MapSwipe

If you'd like to modify and improve the MapSwipe web app, read through the following to get familiar with the project. Please also read CONTRIBUTING.

Technology Used

The app is written in Vue. It uses the same backend as the mobile app:

1. Firebase provides the backend database. It is protected with security rules so that users and contributors to this open source project can not cause damage.
2. The workers on the backend are running on Google Cloud and handle pre-processing and post-processing the data.

Project Setup

yarn

Compile and Hot-Reload for Development

yarn dev

Lint with ESLint

yarn lint

Format with prettier

yarn format

Pre-commit hook

Automate linting and formatting as pre-commit hook (from repo root):

ln -fs ../../pre-commit-hook .git/hooks/pre-commit
chmod ug+x .git/hooks/*

Deployment

On any push to the main branch of this repository, the most recent tagged version and the latest version are built and deployed to web.mapswipe.org and web.mapswipe.org/dev respectively (see deployment workflow).

Acknowledgement

The web app was initially developed by HeiGIT with the support of the Humanitarian OpenStreetMap Team. It is based on an application developed for the UndercoverEisAgenten project. UndercoverEisAgenten is funded by the Federal Ministry of Education and Research as part of the Citizen Science funding area. It is one of 15 projects that will advance the cooperation between citizens and scientists in terms of content and methodology as well as provide answers to society’s challenges until the end of 2024.