@trailstash/ultra/docs/index.md

A web based tool for making MapLibre GL maps with data from sources such as Overpass, GeoJSON, GPX, KML, TCX, etc

# Introduction

Ultra (née Overpass Ultra) is a web-application made to simplify making maps with [MapLibre GL
JS](https://maplibre.org) with data from various file/query types such as Overpass, GeoJSON, GPX, and more.

![](./assets/screenshot.png)

## Getting Started
All Ultra maps are defined by a document containing an optional configuration and optional query. For
example, to query bicycle repair stations using the [Overpass API](https://overpass-api.de), you
can make a document containing an OverpassQL query:

```
node[amenity=bicycle_repair_station]({{bbox}});
out;
```

Or to place a red marker at Eiffel Tower using a GeoJSON document as the query:
```
---
style:
  layers:
    - type: symbol
      icon-image: maki:marker
      icon-color: red
      icon-anchor: bottom
---
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {},
      "geometry": {
        "coordinates": [
          2.2945119627238455,
          48.85826635779679
        ],
        "type": "Point"
      }
    }
  ]
}
```

For more examples, see the [Examples](./Examples/index.md) and [MapLibre
Examples](./MapLibre-Examples/index.md) sections.

## Configuration

Various aspects of Ultra, such as styling, can be
configured via [YAML front-matter](./yaml.md).

## Styling

Ultra supports styling using an extended version of the the
[MapLibre Style Spec](https://maplibre.org/maplibre-style-spec/).

See the [Styling](./style.md) section for more information.