Run Locally

Prerequisites

• Python 3.x
• Node.js 18+
• npm
• Optional: Docker Desktop

Fastest Start (Recommended)

From repository root:

.\start-local.ps1

Or:

start-local.cmd

This starts:

• backend on http://127.0.0.1:80
• viewer on http://127.0.0.1:5173
• browser opens automatically

Manual Start

1. Start backend

python grb_webservice.py

2. Start viewer

cd brdr-viewer\brdr-viewer
npm install
npm run dev -- --host 127.0.0.1 --port 5173

Open http://127.0.0.1:5173.

Docker Backend Option

From repository root:

docker build -f Dockerfile . -t grb_webservice
docker run --rm -p 80:80 --name grb_webservice grb_webservice

Make sure Docker Desktop / Docker Engine is running before executing these commands.

This image bundles both backend and viewer:

• API: http://127.0.0.1:80
• Swagger: http://127.0.0.1:80/docs
• Viewer: http://127.0.0.1:80/viewer

Common Issues

Viewer shows fetch errors

• Ensure backend is running on http://127.0.0.1:80.
• Check CORS origin (localhost:5173 / 127.0.0.1:5173).
• Verify outbound access from backend to GRB upstream services.

Empty or flat chart values

• Trigger recalculation after drawing or editing geometry.
• Ensure geometry is valid and has area.