{"id":13581473,"url":"https://github.com/maplibre/maputnik","last_synced_at":"2026-01-12T07:46:15.279Z","repository":{"id":11170092,"uuid":"67726921","full_name":"maplibre/maputnik","owner":"maplibre","description":"An open source visual editor for the 'MapLibre Style Specification'","archived":false,"fork":false,"pushed_at":"2025-05-09T13:34:10.000Z","size":111349,"stargazers_count":2258,"open_issues_count":97,"forks_count":427,"subscribers_count":75,"default_branch":"main","last_synced_at":"2025-05-12T00:56:52.636Z","etag":null,"topics":["cartography","geo","geospatial","gis","maplibre","maplibre-gl-js","mapping","maps","maputnik","vector-tiles"],"latest_commit_sha":null,"homepage":"https://www.maplibre.org/maputnik","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maplibre.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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,"zenodo":null},"funding":{"github":["maplibre"],"open_collective":"maplibre"}},"created_at":"2016-09-08T17:52:22.000Z","updated_at":"2025-05-11T18:18:28.000Z","dependencies_parsed_at":"2024-01-02T11:28:01.412Z","dependency_job_id":"153dadef-ab18-47fb-bd9f-5ee9993ea723","html_url":"https://github.com/maplibre/maputnik","commit_stats":{"total_commits":1462,"total_committers":68,"mean_commits":21.5,"dds":0.56703146374829,"last_synced_commit":"172d4d527872e92f2c522f603ee7378c44488cb1"},"previous_names":["maplibre/maputnik","maputnik/editor"],"tags_count":31,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maplibre%2Fmaputnik","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maplibre%2Fmaputnik/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maplibre%2Fmaputnik/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maplibre%2Fmaputnik/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maplibre","download_url":"https://codeload.github.com/maplibre/maputnik/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253700655,"owners_count":21949698,"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":["cartography","geo","geospatial","gis","maplibre","maplibre-gl-js","mapping","maps","maputnik","vector-tiles"],"created_at":"2024-08-01T15:02:02.822Z","updated_at":"2026-01-12T07:46:15.274Z","avatar_url":"https://github.com/maplibre.png","language":"TypeScript","funding_links":["https://github.com/sponsors/maplibre","https://opencollective.com/maplibre"],"categories":["TypeScript","Map Styling"],"sub_categories":["Style Editors"],"readme":"\u003cimg width=\"200\" alt=\"Maputnik logo\" src=\"https://cdn.jsdelivr.net/gh/maputnik/design/logos/logo-color.png\" /\u003e\n\n# Maputnik\n[![GitHub CI status](https://github.com/maplibre/maputnik/workflows/ci/badge.svg)][github-action-ci]\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)][license]\n\n[github-action-ci]: https://github.com/maplibre/maputnik/actions?query=workflow%3Aci\n[license]:          https://tldrlegal.com/license/mit-license\n\nA free and open visual editor for the [MapLibre GL styles](https://maplibre.org/maplibre-style-spec/)\ntargeted at developers and map designers.\n\n\n## Usage\n\n- :link: Design your maps online at **\u003chttps://www.maplibre.org/maputnik/\u003e** (all in local storage)\n- :link: Use the [Maputnik CLI](https://github.com/maplibre/maputnik/wiki/Maputnik-CLI) for local style development\n- In a Docker, run this command and browse to http://localhost:8888, Ctrl+C to stop the server.\n\n```bash\ndocker run -it --rm -p 8888:8000 ghcr.io/maplibre/maputnik:main\n```\n\nTo see the CLI options (for example file watching or style serving) run:\n```bash\ndocker run -it --rm -p 8888:8000 ghcr.io/maplibre/maputnik:main --help\n```\nYou might need to mount a volume (`-v`) to be able to use these options.\n\n## Documentation\n\nThe documentation can be found in the [Wiki](https://github.com/maplibre/maputnik/wiki). You are welcome to collaborate!\n\n- :link: **Study the [Maputnik Wiki](https://github.com/maplibre/maputnik/wiki)**\n- :video_camera: Design a map from Scratch https://youtu.be/XoDh0gEnBQo\n\n[![Design Map from Scratch](https://j.gifs.com/g5XMgl.gif)](https://youtu.be/XoDh0gEnBQo)\n\n## Develop\n\nMaputnik is written in typescript and is using [React](https://github.com/facebook/react) and [MapLibre GL JS](https://maplibre.org/projects/maplibre-gl-js/).\n\nWe ensure building and developing Maputnik works with the [current active LTS Node.js version and above](https://github.com/nodejs/Release#release-schedule).\n\nCheck out our [Internationalization guide](./src/locales/README.md) for UI text related changes.\n\n### Getting Involved\nJoin the #maplibre or #maputnik slack channel at OSMUS: get an invite at https://slack.openstreetmap.us/ Read the the below guide in order to get familiar with how we do things around here.\n\nInstall the deps, start the dev server and open the web browser on `http://localhost:8888/`.\n\n```bash\n# install dependencies\nnpm install\n# start dev server\nnpm run start\n```\n\nIf you want Maputnik to be accessible externally use the [`--host` option](https://vitejs.dev/config/server-options.html#server-host):\n\n```bash\n# start externally accessible dev server\nnpm run start -- --host 0.0.0.0\n```\n\nThe build process will watch for changes to the filesystem, rebuild and autoreload the editor.\n\n```\nnpm run build\n```\n\nLint the JavaScript code.\n\n```\n# run linter\nnpm run lint\nnpm run lint-css\nnpm run sort-styles\n```\n\n## Tests\nFor E2E testing we use [Cypress](https://www.cypress.io/)\n\n [Cypress](https://www.cypress.io/) doesn't start a server so you'll need to start one manually by running `npm run start`.\n\nNow open a terminal and run the following using *chrome*:\n\n```\nnpm run test\n```\nor *firefox*:\n```\nnpm run test -- --browser firefox\n```\n\nSee the following docs for more info: (Launching Browsers)[https://docs.cypress.io/guides/guides/launching-browsers]\n\nYou can also see the tests as they run or select which suites to run by executing:\n\n```\nnpm run cy:open\n```\n\n## Release process\n\n1. Review [`CHANGELOG.md`](/CHANGELOG.md)\n   - Double-check that all changes included in the release are appropriately documented.\n   - To-be-released changes should be under the \"main\" header.\n   - Commit any final changes to the changelog.\n2. Run [Create bump version PR](https://github.com/maplibre/maputnik/actions/workflows/create-bump-version-pr.yml) by manual workflow dispatch and set the version number in the input. This will create a PR that changes the changelog and `package.json` file to review and merge.\n3. Once merged, an automatic process will kick in and creates a GitHub release and uploads release assets.\n\n\n## Sponsors\n\nThanks to the supporters of the **[Kickstarter campaign](https://www.kickstarter.com/projects/174808720/maputnik-visual-map-editor-for-mapbox-gl)**. This project would not be possible without these commercial and individual sponsors.\nYou can see this file's history for previous sponsors of the original Maputnik repo.\nRead more about the MapLibre Sponsorship Program at https://maplibre.org/sponsors/.\n\n## License\n\nMaputnik is [licensed under MIT](LICENSE) and is Copyright (c) Lukas Martinelli and Maplibre contributors.\nAs contributor please take extra care of not violating any Mapbox trademarks. Do not get inspired by other map studios and make your own decisions for a good style editor.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaplibre%2Fmaputnik","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaplibre%2Fmaputnik","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaplibre%2Fmaputnik/lists"}