debug gps scan idle
mode map
accuracy --
lat --
lon --
Selected Balloon
No balloon selected
Tap a balloon marker on the map.

A single 9:16 screen handles both parts of the loop: a tilted overworld view for nearby spawns and a Balloon Mode encounter when the player is in range.

Geolocation / Balloon Hunt

Balloon Hunt is the first proof of concept for the geolocation game stack: a phone-native loop with live GPS, debug coordinates, real OpenStreetMap geometry, nearby spawn anchors, and a camera-backed encounter mode.

The reusable foundation is split into four layers: location source, vector map source, world-spawn rules, and encounter mode. Future geolocation or AR games can keep the same lower layers and only swap the spawn and reward logic.

Location Source

Live GPS + debug GPS. Use `watchPosition` on device, or pin exact lat/lon/heading values for repeatable testing.

Map Geometry

Real streets, parks, water, and buildings. The prototype pulls local vector geometry and renders it as simple lines and fills.

World Spawns

Balloons attach to real focal points. Amenities, monuments, shops, and landmarks become spawn anchors, with synthetic fallback anchors when needed.

Encounter Mode

Map mode flows into camera mode. When the player gets close enough, the same phone screen swaps into AR-style slingshot play.