Skip to content

Development setup

This page describes the steps needed to start with frontend development. It is assumed that you are using Ubuntu Linux and you will need Docker, docker-compose, and git.

Step 1: Clone the repository

Clone the Gramps.js repository

git clone
cd Gramps.js

Step 2: Build and start the development containers

To build and start the containers running the Gramps Web backend with the Gramps example database, as well as the frontend in development mode, simply run

docker-compose up -d

Options for logging in are: owner, editor, contributor, guest or member (use same word for both username and password).


Do not use the development server in production.

As part of the build process, git hooks for formatting and linting will be installed as well.

Usage instructions

Once the containers are up and running, Gramps Web will be accessible at http://localhost:5555.


Note since the *.json translation files are imported with the new syntax suggested in T39, you must use the Chrome or Chromium browser for the development server to work without errors. This issue is about to change in the future.

Once you make changes to the frontend code, you browser will be reloaded automatically.

The installed git hooks will format and lint the code on every commit. You can run the scripts manually using

docker-compose run gramps-frontend format
docker-compose run gramps-frontend lint