Epi Scanner

Real-time epidemiological surveillance dashboard for dengue and chikungunya in Brazil. Built with Next.js and Mosqlimate API.

Stack

• Framework: Next.js 16 (App Router, Turbopack)
• Maps: Leaflet + react-leaflet
• UI: Tailwind CSS + shadcn/ui
• Charts: Recharts
• Data: Mosqlimate REST API
• Container: Docker Compose

Getting Started

Prerequisites

• Node.js 22+
• Docker and Docker Compose

Development

# Install dependencies
npm install
cp .env.example .env  # adjust values if needed

# Start dev server
npm run dev

The app will be available at http://localhost:3000.

Alternatively, run the dev server inside a container with hot reload:

make up   # or set ENV=dev in .env (default in .env.example)

The Makefile picks the compose file from the ENV variable (dev → docker-compose.dev.yaml, otherwise → docker-compose.yaml). The same targets work for both environments:

Target	Description
make up	start the stack
make down	stop the stack
make logs	follow the logs
make image	build the image

Override on the fly, e.g. make up ENV=prod.

Production

# Build and start with Docker
docker compose up -d --build

The production stack uses docker-compose.yaml and is compatible with Coolify. Required environment variables:

Variable	Description
EPISCANNER_API_URL	Mosqlimate/EpiScanner API base URL
EPISCANNER_API_KEY	API key for the EpiScanner datastore

Optional: FRONTEND_PORT, UID, GID, NEXT_PUBLIC_URL_PREFIX.

GeoJSON Data

State boundary files are served from public/states/{UF}.json. These are Brazilian municipality polygons from geobr.

To regenerate them:

python scripts/download_geojson.py

API Routes

Route	Description
/api/cities	Municipalities for a state
/api/top-cities	Top municipalities by transmission weeks
/api/maps/weeks	Transmission week counts per municipality
/api/maps/r0	R₀ values per municipality
/api/maps/model-eval	Model evaluation rates
/api/timeseries	Weekly case counts for a city
/api/parameters	SIR model parameters
/api/geolocation	Auto-detect user's state by IP

Data Source

Data is served by the Mosqlimate API. See the episcanner-downloader repository for data pipeline details.