gpxstudio/gpx.studio

gpx.studio is an online tool for creating and editing GPX files.

This repository contains the source code of the website.

Contributing

Please create an issue if you find a bug or have a feature request.

Code contributions are also welcome, but except for obvious bug fixes, please open an issue first to discuss the changes you would like to make.

Translation

The website is translated by volunteers on a collaborative translation platform. You can help complete and improve the translations by joining the Crowdin project. If you would like to start the translation in a new language, please contact me or create an issue.

Any help is greatly appreciated!

Development

The code is split into two parts:

• gpx: a Typescript library for parsing and manipulating GPX files,
• website: the website itself, which is a SvelteKit application.

You will need Node.js to build and run these two parts.

Building the gpx library

cd gpx
npm install
npm run build

Running the website

To be able to load the map, you will need to create your own MapTiler key and store it in a .env file in the website directory.

cd website
echo PUBLIC_MAPTILER_KEY={YOUR_MAPTILER_KEY} >> .env
npm install
npm run dev

Credits

This project has been made possible thanks to the following open source projects:

• Development:
  • Svelte and SvelteKit — seamless development experience
  • MDsveX — allowing a Markdown-based documentation
• Design:
  • shadcn-svelte — beautiful components
  • @lucide/svelte — beautiful icons
  • tailwindcss — easy styling
  • Chart.js — beautiful and fast charts
• Logic:
  • immer — complex state management
  • Dexie.js — IndexedDB wrapper
  • fast-xml-parser — fast GPX file parsing
  • SortableJS — creating a sortable file tree
• Mapping:
  • MapLibre GL JS — beautiful and fast interactive map rendering
  • GraphHopper — powerful routing engine
  • OpenStreetMap — open map data used by most of the map layers, and by the routing engine
  • Mapterhorn — high-quality open terrain data used by some map layers (including for 3D), and by the routing engine
• Search:
  • DocSearch — search engine for the documentation

License

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