# Maps — Curated Travel Maps
# https://maps.girard-davila.net/
# Format: https://llmstxt.org
# Last updated: 2026-04-18

> Hand-picked travel maps from real family experiences across South East Asia and Europe.
> GPS-precise spots, honest notes, opening hours, prices. No generic tourist lists.

Maps is an open-source Hugo + Leaflet.js project. Data lives in GeoJSON/TopoJSON files under `static/`. Any user can add places via in-browser PR flow or git. Community maps are auto-generated from Reddit threads via `scripts/reddit_to_map.py` (spaCy NER + Photon/Nominatim geocoding).

## Topic Sub-files

Load only what you need — each file is self-contained:

- [Destinations & Overview](https://maps.girard-davila.net/llms_destinations.txt) — all available maps, project description, changelog
- [GeoJSON Schema & Categories](https://maps.girard-davila.net/llms_schema.txt) — feature schema, coord_source enum, category/colour tables per map
- [Contributing New Places](https://maps.girard-davila.net/llms_contributing.txt) — in-browser PR flow, CLI git workflow, new destination setup, reddit_to_map.py usage
- [Geocoding APIs](https://maps.girard-davila.net/llms_geocoding.txt) — Nominatim, LocationIQ, Photon: code examples, rate limits, coord_source mapping, dedup
- [Toolbar, Embed & GitHub](https://maps.girard-davila.net/llms_toolbar.txt) — toolbar actions, embed mode (?embed=1), load custom data, GitHub Device Flow, OsmAnd/GPX
- [Technical Stack & Files](https://maps.girard-davila.net/llms_technical.txt) — Hugo layout structure, TopoJSON format, key file paths, window.MAP_CONFIG, env vars

## Quick Reference

**Live maps**
- Koh Samui: https://maps.girard-davila.net/koh-samui/
- Lamai Beach: https://maps.girard-davila.net/lamai/
- Hoi An: https://maps.girard-davila.net/hoi-an/
- Fishing Expedition: https://maps.girard-davila.net/fishing-boat/
- 7-Eleven Koh Samui (65 stores): https://maps.girard-davila.net/711-samui/
- Reddit: Where do I stay in Koh Samui?: https://maps.girard-davila.net/where-do-i-stay-in-koh-samui/
- Reddit: Phuket › Krabi › Koh Yao Yai Roadtrip (Day 1–5): https://maps.girard-davila.net/roadtrip-phuket-krabi-koh-yao-yai-phuket/

**Source**: https://github.com/alx/travel-guide
**Contact**: floating ✉️ button on every page
**Author**: alxgirard