Outdoors

A Free and Open-Source map style for the great outdoors.

Warning

This project is currently a Proof of Concept. It's a work in progress, so please treat it as such.

View Demo →

---

Outdoors combines a number of Free and Open-Source data sources and software projects, without which this project would not be possible.

Key Sources

• OpenFreeMap — Base vector tiles (OpenMapTiles schema) for the entire planet.
• Mapterhorn — Powers 3D terrain, hillshading & contour lines.
• Open GIS — Outdoor-specific POIs, low-level paths & contour service for the planet. See Tile Server.

Key Dependencies

• OpenStreetMap
• MapLibre Style Spec
• OSM Liberty
  • Natural Earth Tiles
  • Maki
  • Orange Mug
• OpenMapTiles
• Planetiler
• maplibre-contour
• contour-mvt-server

Build

npm install                           # Install dependencies
npm run build                         # Build `style.json` from `scripts/build.mjs` (also validates)

Development

The dev server uses the same compare app as the demo, with HMR support.

npm install                           # Install dependencies
npm run dev                           # Start Vite dev server + auto-build watcher

Other Scripts

# Validate
npm run validate:style                # Validate `style.json` (MapLibre style spec)

# Demo
npm run demo:build                    # Build demo (`demo/`)
npm run demo:preview                  # Preview demo

# Screenshots
npx playwright install chromium
npm run screenshots                   # Regenerate every shot in shots.json
npm run screenshots -- --name <id>    # Regenerate a single shot by id

---

Read the Docs →