Contribute — Open Pilgrimages

Every pilgrimage tradition deserves to be mapped, understood, and shared openly.

What We Need Most

Tell Us What You Know

Open a GitHub issue describing the route, correction, or experience you'd like to share. No technical skills needed — we'll help shape your knowledge into data.

Propose a new pilgrimage route
Report a data error or missing waypoint
Share your walking experience for interior journey content

Open an Issue →

Or Contribute Directly

Fork the repository, edit the data files, and submit a pull request. Our JSON schemas validate your changes automatically.

Fix waypoint coordinates or metadata
Add interior journey narratives for stages
Build out a complete new route

git clone https://github.com/walktalkmeditate/open-pilgrimages.git
cd open-pilgrimages
npm install
npm run validate    # Check your changes against schemas

Each route follows a standard four-file structure:

routes/{route-id}/
  metadata.json        # Overview, tradition, culture, logistics
  route.geojson        # GeoJSON route geometry
  stages.json          # Stage breakdowns with interior journey
  waypoints.geojson    # Points of interest along the route

See the full contributing guide for detailed instructions.

Data Quality

Code of Conduct

This project serves pilgrims and the pilgrimage community worldwide. We welcome contributions from all traditions and backgrounds. Be respectful of sacred sites, cultural practices, and the diverse motivations people bring to pilgrimage.

Convention	Standard
Coordinates	`[longitude, latitude, altitude]` (GeoJSON standard). Altitude in meters.
Distances	Kilometers, measured along the route path.
Localization	`{ "en": "...", "ja": "..." }` — English always required.
Sources	Include source URLs and access dates in the `provenance` section.