imgoodbai/mapgogogo

MapGoGoGo is a mobile-first web app that turns a real neighborhood, campus, or city district into a shared map challenge. An organizer picks a geographic area on a map, sets a radius and time limit, then shares a link. Everyone who joins opens that link on their phone, allows location access, and starts walking. As participants move through the challenge area, the map grid squares they physically pass over light up, revealing the underlying map. The goal is for a group to collectively illuminate as much of the zone as possible. The app is designed for activities like campus check-in walks, park jogs, neighborhood exploration, shopping district promotions, and offline community events. It uses a hexagonal grid system called H3 to track which areas have been covered, with each cell turning visible only when someone physically passes through it. The organizer sees a leaderboard showing how much each participant has contributed, and both the challenge listing and individual challenge pages include a shareable link for spreading the challenge through messaging apps or social channels. On the technical side, the frontend is built with React and TypeScript, compiled with Vite, and maps are provided by the Amap JavaScript API, a Chinese mapping platform. The backend runs on Python with FastAPI and stores data in SQLite, which is appropriate for prototypes and small-scale internal testing. The project notes that SQLite could be replaced with PostgreSQL if the app sees heavy concurrent writes or slow queries at larger scale. To run the app locally you need Python, Node.js, and an Amap Web API key. Without the key, the app runs in a simulated map mode so you can still test the challenge creation flow, the leaderboard, and the admin page. Real GPS lighting requires a phone browser over HTTPS. The project notes that WeChat's built-in browser works for sharing and preview, but the system browser is recommended for actual position tracking. The app is currently a prototype with some stated limits: all participants share a single challenge at a time, the desktop simulator is for local preview only and does not write to the server, and the page must stay in the foreground for GPS tracking to work.