Smart and innovative frontend UI for Citizen Science projects

🐗 Trapper Frontend

This is the Citizen Science frontend for the TRAPPER project. It is an Angular application leveraging NX to manage the monorepo. At this moment, this repo contains the following applications:

trapper-frontend-cs: Citizen Science edition of the frontend

🏗️ Local development

Prerequisites

You will need NodeJS 18 and NPM installed on your machine.

First, install dependencies using npm install.

Running the application

To run the application, use npm run start. This will start the application on port 4200.

By default, the application will connect to the backend running on https://dev.trapper-project.org/. To change this, you can set the TRAPPER_BACKEND_URL environment variable.

Formating

To format the code, use npm run format. Code formatting is done using Prettier. It is enforced in the CI pipeline.

Linting

To lint the code, use npm run lint. Linting is done using ESLint. It is enforced in the CI pipeline.

Building

To build the application, use npm run build.

Deploying

You can deploy the application using docker image build by the CI pipeline. The image is available on the GitLab container registry.

You can specify the backend URL using the TRAPPER_BACKEND_URL environment variable. The correct format for url is ${protocol}://${host}:${port}. For example, https://dev.trapper-project.org, without a trailing slash.

You can run the image using the following command:

Example :

docker pull registry.gitlab.com/trapper-project/trapper-frontend:main
docker run -p 8042:80 -e TRAPPER_BACKEND_URL=https://dev.trapper-project.org registry.gitlab.com/trapper-project/trapper-frontend:main

🌐 Demo

Trapper Expert demo instance does not include Trapper Citizen Science or Trapper AI yet.

📝 Documentation

TRAPPER documentation.

If you are using TRAPPER, please cite our work:

Bubnicki, J.W., Churski, M. and Kuijper, D.P.J. (2016), trapper: an open source web-based application to manage camera trapping projects. Methods Ecol Evol, 7: 1209-1216. https://doi.org/10.1111/2041-210X.12571

For more news about TRAPPER please visit the Open Science Conservation Fund (OSCF) website and OSCF LinkedIn profile.

🏢 Who is using TRAPPER?

Mammal Research Institute Polish Academy of Sciences;
Karkonosze National Park;
Swedish University of Agricultural Sciences;
Svenska Jägareförbundet;
Meles Wildbiologie;
University of Freiburg Wildlife Ecology and Management;
Bavarian Forest National Park;
Georg-August-Universität Göttingen;
KORA - Carnivore Ecology and Wildlife Management;
and many more individual scientists and ecologies;

💲 Funders and Partners

🤝 Support

Feel free to add a new issue with a respective title and description on the TRAPPER issue tracker. If you already found a solution to your problem, we would be happy to review your pull request.

If you prefer direct contact, please let us know: contact@os-conservation.org

We also have TRAPPER Mailing List and TRAPPER Slack.

Table of Contents