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 four parts:

• gpx-rs: a Rust library for parsing and manipulating GPX files (the engine), and the interface to it that the next two share (gpx_engine::api),
• wasm: the engine for the browser, compiled to WebAssembly,
• tauri: the desktop app, which runs the engine natively,
• website: the website itself, which is a SvelteKit application. It also is the UI of the desktop app.

You will need Node.js, Rust and wasm-pack to build and run the website. See tauri for the desktop app.

Building the WebAssembly engine

cd wasm
wasm-pack build --target bundler

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:
  • 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.