Skip to content

zenfinity/irlrpgmap

Repository files navigation

irlrpgmap

A personal map that reveals the world as you explore it — like fog of war in an RPG, but for real life.

Log places you've been and watch your map come alive. The more you've explored a neighborhood, the more the fog lifts.

irlrpgmap screenshot

irlrpgmap.live


How it works

Sign up, then use the Wuz Here button to add places you've been:

  • GPS — one tap to mark your current location
  • Photo — select photos from your camera roll; GPS and timestamps are read from EXIF metadata locally, clustered into places, and logged (nothing is uploaded)
  • Search — find any place by name and pick the date you visited
  • Import — bulk import your Google Maps Timeline export (JSON) for historical data

In the World view, each neighborhood you've visited appears as a soft fog reveal — brighter the more you've explored it. Click a neighborhood to enter the Area view, where the real neighborhood boundary becomes a dungeon wall and your visited spots clear the fog inside it.


Stack


Roadmap

  • Granular familiarity levels (explored, searched, heard of)
  • Map sharing
  • Support for additional location history formats
  • Re-geocode existing visits with null neighborhood (locality fallback added post-import)

Local development

npm install
npm run dev

Requires a .env file with:

DATABASE_URL=...
BETTER_AUTH_SECRET=...
BETTER_AUTH_URL=http://localhost:5173
VITE_MAPBOX_TOKEN=...
GH_TOKEN=...

Built with Claude Code by Anthropic.

About

Discovery as a state of mind, a map to reflect it

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors