{"id":13773922,"url":"https://github.com/maplibre/maplibre-style-spec","last_synced_at":"2025-04-04T07:07:24.908Z","repository":{"id":66246270,"uuid":"603857830","full_name":"maplibre/maplibre-style-spec","owner":"maplibre","description":"MapLibre Style Specification \u0026 Utilities","archived":false,"fork":false,"pushed_at":"2025-03-24T09:18:29.000Z","size":25110,"stargazers_count":112,"open_issues_count":54,"forks_count":75,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-03-29T11:09:22.536Z","etag":null,"topics":["hacktoberfest"],"latest_commit_sha":null,"homepage":"https://maplibre.org/maplibre-style-spec/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maplibre.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":"CODE-OF-CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY_POLICY.txt","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["maplibre"],"open_collective":"maplibre"}},"created_at":"2023-02-19T19:12:13.000Z","updated_at":"2025-03-24T09:17:39.000Z","dependencies_parsed_at":"2023-03-10T23:44:46.065Z","dependency_job_id":"7b3a618b-96f7-478f-b47c-711559d62e35","html_url":"https://github.com/maplibre/maplibre-style-spec","commit_stats":{"total_commits":700,"total_committers":35,"mean_commits":20.0,"dds":"0.30000000000000004","last_synced_commit":"93a8cd30b84b815ea57d49172959038a57a86759"},"previous_names":["maplibre/maplibre-gl-style-spec"],"tags_count":43,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maplibre%2Fmaplibre-style-spec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maplibre%2Fmaplibre-style-spec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maplibre%2Fmaplibre-style-spec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maplibre%2Fmaplibre-style-spec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maplibre","download_url":"https://codeload.github.com/maplibre/maplibre-style-spec/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247135144,"owners_count":20889421,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest"],"created_at":"2024-08-03T17:01:21.820Z","updated_at":"2025-04-04T07:07:24.886Z","avatar_url":"https://github.com/maplibre.png","language":"TypeScript","funding_links":["https://github.com/sponsors/maplibre","https://opencollective.com/maplibre"],"categories":["Map Styling"],"sub_categories":[],"readme":"# MapLibre Style Specification \u0026 Utilities\n\n[![NPM Version](https://badge.fury.io/js/@maplibre%2Fmaplibre-gl-style-spec.svg)](https://npmjs.org/package/@maplibre/maplibre-gl-style-spec) \n[![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg?style=flat)](LICENSE.txt) [![PRs](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat)](https://opensource.org/licenses/BSD-3-Clause) [![codecov](https://codecov.io/gh/maplibre/maplibre-style-spec/branch/main/graph/badge.svg)](https://codecov.io/gh/maplibre/maplibre-style-spec)\n\nThis repository contains code and reference files that define the MapLibre style specification and provides some utilities for working with MapLibre styles.\n\nThe style specification is used in MapLibre GL JS and in MapLibre Native. Our long-term goal is to have feature parity between the web and the native libraries.\n\n## Contributing\n\nIf 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.\n\nWe aim to avoid breaking changes in the MapLibre style specification, because it makes life easier for our users.\n\n## Documentation\n\nThe [documentation](https://maplibre.org/maplibre-style-spec) of the style specification also lives in this repository. We use [MkDocs](https://www.mkdocs.org/) with the [Material for MkDocs](https://squidfunk.github.io/mkdocs-material) theme. \n\nTo work on the documentation locally, you need to have Docker installed and running. Start MkDocs with\n\n```\nnpm run mkdocs\n```\n\nMost of the documentation is generated (from e.g. `v8.json`). In another terminal, run:\n\n```\nWATCH=1 npm run generate-docs\n```\n\nThis will re-run the generation script when needed.\n\nNote that generated files should not be checked in and they are excluded in `.gitignore`. Make sure to keep this file up-to-date and ignore generated files while making sure static Markdown files are not ignored.\n\n## NPM Package\n\n\nThe MapLibre style specification and utilities are published as a separate npm\npackage so that they can be installed without the bulk of GL JS.\n\n    npm install @maplibre/maplibre-gl-style-spec\n\n## CLI Tools\n\nIf you install this package globally, you will have access to several CLI tools.\n\n    npm install @maplibre/maplibre-gl-style-spec --global\n\n### `gl-style-migrate`\n\nThis repo contains scripts for migrating GL styles of any version to the latest version\n(currently v8). Migrate a style like this:\n\n```bash\n$ gl-style-migrate bright-v7.json \u003e bright-v8.json\n```\n\nTo migrate a file in place, you can use the `sponge` utility from the `moreutils` package:\n\n```bash\n$ brew install moreutils\n$ gl-style-migrate bright.json | sponge bright.json\n```\n\n### `gl-style-format`\n\n```bash\n$ gl-style-format style.json\n```\n\nWill format the given style JSON to use standard indentation and sorted object keys.\n\n### `gl-style-validate`\n\n```bash\n$ gl-style-validate style.json\n```\n\nWill validate the given style JSON and print errors to stdout. Provide a\n`--json` flag to get JSON output.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaplibre%2Fmaplibre-style-spec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaplibre%2Fmaplibre-style-spec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaplibre%2Fmaplibre-style-spec/lists"}