Development setup

This page describes the steps needed to start with frontend development. It is assumed that you are using Ubuntu Linux.

Install Node.js

To get started, install Node.js with nvm:

nvm install node

Clone the Gramps.js repository

git clone git@github.com:gramps-project/Gramps.js.git
cd Gramps.js

To install all dependencies, run

npm install

at the repository's root.

To see Gramps Web live in action, you need a running Gramps Web API backend where the frontend can fetch its data from.

If you have followed the setup steps for backend development, this can be achieved with a command like

python3 -m gramps_webapi --config path/to/config run --port 5555

A backend at a different location can be used during development by changing the __APIHOST__ variable in api.js.

You can now run the frontend with

npm run start