Contributing

Thanks for your interest in VersaTiles! This repository hosts the documentation. Code for the various components lives in other repositories under versatiles-org.

The contributions most useful to us, in order:

Add your project to Showcases

If you use VersaTiles in a public project, we'd love to feature it in the Showcases gallery. It has its own repository, versatiles-org/showcases, and its contributing guide explains how to add an entry.

Fix or improve the docs

• Typos and small fixes: the easiest path is the "Edit this page on GitHub" link in the footer of every page on docs.versatiles.org. It opens GitHub's web editor scoped to the right file.
• Larger changes: clone the repo and preview locally before opening a PR:

  npm install
  npm run dev

  This starts the VitePress dev server with hot reload at http://localhost:5173.

Report a bug or request a feature

• Issues with documentation content — open an issue in this repository.
• Issues with VersaTiles itself — pick the right component repository under github.com/versatiles-org. The most active ones:
  • versatiles-rs — Rust server and tooling
  • versatiles-frontend — prebuilt frontend bundle
  • versatiles-style — map styles and sprites
  • versatiles-docker — Docker images including OSM tile generation
• Not sure where it belongs? Open it anywhere — we'll move it.

Get in touch

Drop in on #versatiles:matrix.org for questions, ideas or design discussions.