This page contains useful information for those who wish to develop Mergin.
Install dependencies and run services:
$ docker run -d --rm --name mergin_maps_dev_db -p 5002:5432 -e POSTGRES_PASSWORD=postgres postgres:14
$ docker run -d --rm --name mergin_maps_dev_redis -p 6379:6379 redis$ pip3 install pipenv
$ cd server
# Install dependencies with pipenv
# Note: You can append --three flag in older versions of pipenv (< 3.16.8 2023-02-04)
$ pipenv install --dev
$ export FLASK_APP=application; export COLLECT_STATISTICS=0
$ pipenv run flask init-db
# create admin user
$ pipenv run flask user create admin topsecret --is-admin --email [email protected]
# create (non admin) user
$ pipenv run flask user create user topsecret --email [email protected]
$ pipenv run celery -A application.celery worker --loglevel=info &
$ pipenv run flask run # run dev server on port 5000Before installing the web applications, make sure you have Node.js installed in a supported version. The applications require Node.js version 17 or higher.
$ cd web-app
$ yarn install
$ yarn link:dependencies # link dependencies
$ yarn build:libs # bild libraries @mergin/lib @mergin/admin-lib
$ yarn dev # development client web application dev server on port 8080 (package @mergin/app)
$ yarn dev:admin # development admin appplication dev server on port 8081 (package @mergin/admin-app)If you are developing a library package (named *-lib), it is useful to watch the library for changes instead of rebuilding it each time.
To watch the @mergin/lib library while developing:
# watch:admin-lib, etc.
yarn watch:lib
# Also watch type definitions
yarn watch:lib:typesWatching the type definitions is also useful to pick up any changes to imports or new components that are added.
To launch the unit tests run:
$ docker run -d --rm --name testing_pg -p 5435:5432 -e POSTGRES_PASSWORD=postgres postgres:14
$ cd server
$ pipenv install --dev --sequential --verbose
$ pipenv run pytest -v --cov=mergin mergin/tests