MMR Style Specification & Utilities

This repository contains code and reference files that define the MMR style specification and provides some utilities for working with MMR styles.

The style specification is used in MMR GL JS and in MMR Native. Our long-term goal is to have feature parity between the web and the native libraries.

Contributing

If you want to contribute to the style specification, please open an issue with a design proposal. Once your design proposal has been accepted, you can open a pull request and implement your changes.

We aim to avoid breaking changes in the MMR style specification, because it makes life easier for our users.

NPM Package

The MMR style specification and utilities are published as a seperate npm package so that they can be installed without the bulk of GL JS.

npm install mmr-gl-style-spec

CLI Tools

If you install this package globally, you will have access to several CLI tools.

npm install mmr-gl-style-spec --global

gl-style-migrate

This repo contains scripts for migrating GL styles of any version to the latest version (currently v8). Migrate a style like this:

$ gl-style-migrate bright-v7.json > bright-v8.json

To migrate a file in place, you can use the sponge utility from the moreutils package:

$ brew install moreutils
$ gl-style-migrate bright.json | sponge bright.json

gl-style-format

$ gl-style-format style.json

Will format the given style JSON to use standard indentation and sorted object keys.

gl-style-validate

$ gl-style-validate style.json

Will validate the given style JSON and print errors to stdout. Provide a --json flag to get JSON output.