Load Maps from GitHub


Synoptic Panel allows you to load custom maps hosted on the web, but with an important requirement: the hosting service must allow cross-origin requests (CORS). This requirement is a stopper for most cloud services, but GitHub is an exception as it supports CORS by default.

Also, GitHub provides a free hosting service for static files up to 1GB, which makes it a perfect choice for hosting your maps.

ATTENTION: Private GitHub repositories are not supported by Synoptic Panel, so your maps can only be hosted in a public repository, accessible to everyone.

Here is a step-by-step guide to hosting your maps on GitHub and using them in Synoptic Panel:

  1. If you don’t have already one, create an account on GitHub, and then create a new public repository.

  2. Go to the repository page and click on the uploading an existing file link.

  3. Drag and drop your SVG map files to the upload area or click on the choose your files link, then click on the Commit changes button.

  4. After uploading your files, click on the SVG file to open it, and then click on the Raw button to get the URL of the file.

  5. Add the URL to your column bound to the Map URL field in Synoptic Panel or add the map URL directly in the Synoptic Panel interface (see Importing Remote Maps for more info).

That’s it! Now you can use your maps hosted on GitHub in Synoptic Panel.

Last update: Mar 23, 2025