Turn GPX into race-ready maps.

MAPusaur is an open-source GPX-to-map engine that transforms route data into race-ready visuals with elevation profiles. Built for endurance athletes, trail runners, and race organizers.

Race organizers and athletes often:

• export GPX from tools like Google Earth or Strava
• manually recreate maps in Canva or design tools
• rebuild elevation profiles separately
• spend hours aligning visuals

MAPusaur removes that friction by turning raw route data into clean, structured race maps.

• GPX-based route rendering — visualize routes directly from GPX files
• Elevation profile generation — understand ascent and descent visually
• Custom race layouts — adapt visuals for different race formats
• High-resolution export — generate shareable race-ready outputs

• Map data: OpenStreetMap contributors
• Tiles: OpenMapTiles
• Tile hosting: OpenFreeMap
• Geocoding: Nominatim
• Map renderer: MapLibre

bun install
bun run dev

Check .env.example for available variables. Most are optional for local development.

bun run build

docker compose up -d --build

Default: http://localhost:7200

docker compose down

This project is evolving from a cartographic engine into a race-focused GPX system.

• Keep contributions clean and modular
• Follow existing architecture patterns
• Avoid hardcoding values
• Review AI-generated code before submitting

This project builds upon the excellent work from TerraInk .

MAPusaur adapts and extends the engine toward GPX-based race visualization and endurance use cases.

This project is licensed under the MIT License — see the LICENSE file for details.

MAPusaur™ is an independent project.

The underlying codebase is MIT-licensed, but original project names and branding (such as TerraInk) remain the property of their respective owners.