ThePostmanApp

Mobile app for sharing live GPS location and computing optimal street-coverage routes using the Chinese Postman Problem algorithm.

Built with Expo SDK 54, MapLibre GL Native, and Supabase.

Features

• Anonymous session-based location sharing (no account required)
• Real-time multi-user GPS dots on a live map
• Path recording with background location tracking
• Chinese Postman Problem route optimization over OpenStreetMap road graphs
• GPX export and import
• No API keys required — powered by OpenFreeMap and Overpass

Stack

Concern	Choice
Framework	Expo SDK 54 (Managed Workflow)
Language	TypeScript (strict)
Maps	MapLibre GL Native + OpenFreeMap
Real-time	Supabase Realtime Presence
Auth	Supabase Anonymous Sign-in
State	Zustand v5

Requirements

• Node 20 LTS
• A Supabase project (free tier works)
• A Development Build — Expo Go is not supported (background GPS + MapLibre require native config)

Getting started

npm install
cp .env.example .env   # fill in your Supabase URL and anon key
npx expo start

To build for device:

# Android
eas build --profile development --platform android

# iOS (macOS only)
npx expo run:ios