app

app README

Monorepo

Please read the README first.

About

The frontend visualizes our processed data it also provides options to annotate and export the data.

Development

Initial setup

1. Create a /.env file in the root folder based on /.env.example.
2. To test the login, you need to setup your own OSM OAuth 2-Application, see osm-auth and update the credentials.

Start

Run nvm use to user the recommended NodeJS version.

Run npm run dev wich will start docker and ../processing automatically if needed.

Our Tooling

• Framework: NextJS with BlitzJS
• URL State Management: nuqs
• ORM: Prisma
• Styling: Tailwind CSS, Tailwind UI and Headless UI

Running the production bundle locally

In the app/ directory do the following:

1. Make sure npm run dev works as expected. This will make sure all packages are patched.
2. Double check .env.production
3. Run npm run build and npm run start to test the production bundle.

There is also a dockerized version of our frontend:

docker compose --profile frontend build
docker compose --profile frontend up

Helper scripts

All helper scripts run with bun.

• Update mapbox styles – See /scripts/MapboxStyles/README.md on how to fetch updated style definitions from Mapbox.
• Update regional masks – See /scripts/RegionalMasks/README.md on how to fetch updated the regional mask data.
• Update datasets – See /datasets/README.md on how to process and update external datasets.