dependabot[bot] 3ca5b342d4 chore(deps): Bump maplibre-gl from 6.11.2 to 6.12.0 (#2212)
Bumps [maplibre-gl](https://github.com/maplibre/maplibre-gl-js) from
6.11.2 to 6.12.0.
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/maplibre/maplibre-gl-js/releases">maplibre-gl's
releases</a>.</em></p>
<blockquote>
<h2>v6.12.0</h2>
<h3>✨ Features and improvements</h3>
<ul>
<li>Add a <code>zoomToUserAccuracy</code> option to
<code>GeolocateControlOptions</code> to allow control over map zoom
adjustments in line with the Geolocation Position update accuracy, while
<code>trackUserLocation</code> is <code>true</code> (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/7908">#7908</a>,
<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8324">#8324</a>,
continues <a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/7909">#7909</a>)
(by <a
href="https://github.com/timsluis"><code>@​timsluis</code></a>)</li>
<li>With <code>fill-extrusion-rounded-corner-distance</code> set, shade
the walls of a rounded corner as one curved surface by sharing the
vertex normal between walls that meet at a shallow angle, instead of one
flat shade per arc segment (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8475">#8475</a>)
(by <a
href="https://github.com/clement-igonet"><code>@​clement-igonet</code></a>)</li>
<li>Speed up symbol rendering when the set of visible tiles changes, by
rewriting the opacity buffers only of the symbol buckets whose labels
actually changed instead of every bucket of every symbol layer (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8434">#8434</a>)
(by <a
href="https://github.com/cherenkov"><code>@​cherenkov</code></a>)</li>
<li>Add an <code>absolutePadding</code> option to
<code>Map#cameraForBounds</code> and <code>Map#fitBounds</code> to treat
<code>padding</code> as the map's persistent padding instead of adding
it to the current one (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8480">#8480</a>)
(by <a
href="https://github.com/sargunv"><code>@​sargunv</code></a>)</li>
</ul>
<h3>🐞 Bug fixes</h3>
<ul>
<li>fix(CanvasSource): catch load errors and fire map.error like
ImageSource (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8448">#8448</a>)
(<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8450">#8450</a>)
(by <a
href="https://github.com/SatvikMishra08"><code>@​SatvikMishra08</code></a>)</li>
<li>Fix <code>GeoJSONSource</code> still sending its waiting updates to
the worker after the source is removed (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8585">#8585</a>)
(by <a
href="https://github.com/clementperon"><code>@​clementperon</code></a>)</li>
<li>Fix <code>GeoJSONSource</code> memory growing until the page crashes
when <code>setData</code> is called faster than the worker handles it
(<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8585">#8585</a>)
(by <a
href="https://github.com/clementperon"><code>@​clementperon</code></a>)</li>
<li>Fix the map rendering at the display rate instead of going idle over
a DEM with a minimum below sea level when
<code>centerClampedToGround</code> is false (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8605">#8605</a>)
(by <a
href="https://github.com/johncarmack1984"><code>@​johncarmack1984</code></a>)</li>
<li>Fix a gesture over terrain throwing the camera when the terrain
under the center loads after the gesture begins or the terrain switches
off before it ends (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8548">#8548</a>)
(by <a
href="https://github.com/johncarmack1984"><code>@​johncarmack1984</code></a>)</li>
<li>Fix the terrain elevation reading 0 outside the drawn tiles while
the camera is below the terrain, and make that read about 40 times
cheaper (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8539">#8539</a>)
(by <a
href="https://github.com/johncarmack1984"><code>@​johncarmack1984</code></a>)</li>
<li>Fix a hole around the poles of the globe in background, fill and
line layers from zoom 3 (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8638">#8638</a>)
(by <a
href="https://github.com/birkskyum"><code>@​birkskyum</code></a>)</li>
<li>Fix <code>jumpTo</code>, and the setters that use it, pulling the
center elevation onto the terrain when
<code>centerClampedToGround</code> is false (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8566">#8566</a>)
(by <a
href="https://github.com/johncarmack1984"><code>@​johncarmack1984</code></a>)</li>
<li>Fix <code>GeoJSONSource#updateData</code> leaving stale clusters on
untouched tiles after clustering was turned on with
<code>setClusterOptions</code> (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8613">#8613</a>)
(by <a
href="https://github.com/clementperon"><code>@​clementperon</code></a>)</li>
<li>Fix <code>GeoJSONSource#setClusterOptions</code> clustering twice
when called while new data is waiting to be sent (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8613">#8613</a>)
(by <a
href="https://github.com/clementperon"><code>@​clementperon</code></a>)</li>
<li>Fix <code>GeoJSONSource</code> data set with <code>setData</code>
being overwritten by the result of an earlier URL load or
<code>updateData</code> (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8613">#8613</a>)
(by <a
href="https://github.com/clementperon"><code>@​clementperon</code></a>)</li>
<li>Fix fill-extrusion walls facing exactly east or west skipping
<code>fill-extrusion-vertical-gradient</code> and rendering brighter
than the other walls (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8604">#8604</a>)
(by <a
href="https://github.com/birkskyum"><code>@​birkskyum</code></a>)</li>
<li>Fix <code>easeTo</code> and <code>flyTo</code> pulling the center
elevation onto the terrain when <code>centerClampedToGround</code> is
false (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8566">#8566</a>)
(by <a
href="https://github.com/johncarmack1984"><code>@​johncarmack1984</code></a>)</li>
<li>Fix <code>fill-outline-color</code>, and the antialiased edge of
fills, not being drawn when terrain is enabled (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/4200">#4200</a>)
(by <a
href="https://github.com/clement-igonet"><code>@​clement-igonet</code></a>)</li>
<li>Respect map padding when constraining the camera to max bounds, so
the padded viewport can pan fully to its edges (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8501">#8501</a>)
(by <a
href="https://github.com/erenbati"><code>@​erenbati</code></a>)</li>
<li>Fix an unclosed disallowed tag in one attribution erasing the other
attributions, by sanitizing each attribution before joining them (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8569">#8569</a>)
(by <a href="https://github.com/sx4im"><code>@​sx4im</code></a>)</li>
<li>Fix <code>color-relief</code> with a <code>custom</code> DEM
encoding whose <code>redFactor</code>, <code>greenFactor</code> or
<code>blueFactor</code> is 0, where every elevation stop packed to NaN
and the color ramp collapsed (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/6411">#6411</a>)
(by <a
href="https://github.com/drakeo338"><code>@​drakeo338</code></a>)</li>
<li>Fix <code>queryRenderedFeatures</code> missing fill-extrusions on
globe once it renders as mercator (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8560">#8560</a>)
(by <a
href="https://github.com/birkskyum"><code>@​birkskyum</code></a>)</li>
<li>Fix <code>line-offset</code> distorting the line width around joins
(<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8570">#8570</a>)
(by <a href="https://github.com/HarelM"><code>@​HarelM</code></a>)</li>
<li>Cross-fade raster tiles when zooming out from a source's
<code>maxzoom</code>, where the tiles switched instantly (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8517">#8517</a>)
(by <a
href="https://github.com/cherenkov"><code>@​cherenkov</code></a>)</li>
</ul>
</blockquote>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/maplibre/maplibre-gl-js/blob/main/CHANGELOG.md">maplibre-gl's
changelog</a>.</em></p>
<blockquote>
<h2>6.12.0</h2>
<h3>✨ Features and improvements</h3>
<ul>
<li>Add a <code>zoomToUserAccuracy</code> option to
<code>GeolocateControlOptions</code> to allow control over map zoom
adjustments in line with the Geolocation Position update accuracy, while
<code>trackUserLocation</code> is <code>true</code> (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/7908">#7908</a>,
<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8324">#8324</a>,
continues <a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/7909">#7909</a>)
(by <a
href="https://github.com/timsluis"><code>@​timsluis</code></a>)</li>
<li>With <code>fill-extrusion-rounded-corner-distance</code> set, shade
the walls of a rounded corner as one curved surface by sharing the
vertex normal between walls that meet at a shallow angle, instead of one
flat shade per arc segment (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8475">#8475</a>)
(by <a
href="https://github.com/clement-igonet"><code>@​clement-igonet</code></a>)</li>
<li>Speed up symbol rendering when the set of visible tiles changes, by
rewriting the opacity buffers only of the symbol buckets whose labels
actually changed instead of every bucket of every symbol layer (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8434">#8434</a>)
(by <a
href="https://github.com/cherenkov"><code>@​cherenkov</code></a>)</li>
<li>Add an <code>absolutePadding</code> option to
<code>Map#cameraForBounds</code> and <code>Map#fitBounds</code> to treat
<code>padding</code> as the map's persistent padding instead of adding
it to the current one (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8480">#8480</a>)
(by <a
href="https://github.com/sargunv"><code>@​sargunv</code></a>)</li>
</ul>
<h3>🐞 Bug fixes</h3>
<ul>
<li>fix(CanvasSource): catch load errors and fire map.error like
ImageSource (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8448">#8448</a>)
(<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8450">#8450</a>)
(by <a
href="https://github.com/SatvikMishra08"><code>@​SatvikMishra08</code></a>)</li>
<li>Fix <code>GeoJSONSource</code> still sending its waiting updates to
the worker after the source is removed (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8585">#8585</a>)
(by <a
href="https://github.com/clementperon"><code>@​clementperon</code></a>)</li>
<li>Fix <code>GeoJSONSource</code> memory growing until the page crashes
when <code>setData</code> is called faster than the worker handles it
(<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8585">#8585</a>)
(by <a
href="https://github.com/clementperon"><code>@​clementperon</code></a>)</li>
<li>Fix the map rendering at the display rate instead of going idle over
a DEM with a minimum below sea level when
<code>centerClampedToGround</code> is false (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8605">#8605</a>)
(by <a
href="https://github.com/johncarmack1984"><code>@​johncarmack1984</code></a>)</li>
<li>Fix a gesture over terrain throwing the camera when the terrain
under the center loads after the gesture begins or the terrain switches
off before it ends (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8548">#8548</a>)
(by <a
href="https://github.com/johncarmack1984"><code>@​johncarmack1984</code></a>)</li>
<li>Fix the terrain elevation reading 0 outside the drawn tiles while
the camera is below the terrain, and make that read about 40 times
cheaper (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8539">#8539</a>)
(by <a
href="https://github.com/johncarmack1984"><code>@​johncarmack1984</code></a>)</li>
<li>Fix a hole around the poles of the globe in background, fill and
line layers from zoom 3 (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8638">#8638</a>)
(by <a
href="https://github.com/birkskyum"><code>@​birkskyum</code></a>)</li>
<li>Fix <code>jumpTo</code>, and the setters that use it, pulling the
center elevation onto the terrain when
<code>centerClampedToGround</code> is false (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8566">#8566</a>)
(by <a
href="https://github.com/johncarmack1984"><code>@​johncarmack1984</code></a>)</li>
<li>Fix <code>GeoJSONSource#updateData</code> leaving stale clusters on
untouched tiles after clustering was turned on with
<code>setClusterOptions</code> (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8613">#8613</a>)
(by <a
href="https://github.com/clementperon"><code>@​clementperon</code></a>)</li>
<li>Fix <code>GeoJSONSource#setClusterOptions</code> clustering twice
when called while new data is waiting to be sent (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8613">#8613</a>)
(by <a
href="https://github.com/clementperon"><code>@​clementperon</code></a>)</li>
<li>Fix <code>GeoJSONSource</code> data set with <code>setData</code>
being overwritten by the result of an earlier URL load or
<code>updateData</code> (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8613">#8613</a>)
(by <a
href="https://github.com/clementperon"><code>@​clementperon</code></a>)</li>
<li>Fix fill-extrusion walls facing exactly east or west skipping
<code>fill-extrusion-vertical-gradient</code> and rendering brighter
than the other walls (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8604">#8604</a>)
(by <a
href="https://github.com/birkskyum"><code>@​birkskyum</code></a>)</li>
<li>Fix <code>easeTo</code> and <code>flyTo</code> pulling the center
elevation onto the terrain when <code>centerClampedToGround</code> is
false (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8566">#8566</a>)
(by <a
href="https://github.com/johncarmack1984"><code>@​johncarmack1984</code></a>)</li>
<li>Fix <code>fill-outline-color</code>, and the antialiased edge of
fills, not being drawn when terrain is enabled (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/4200">#4200</a>)
(by <a
href="https://github.com/clement-igonet"><code>@​clement-igonet</code></a>)</li>
<li>Respect map padding when constraining the camera to max bounds, so
the padded viewport can pan fully to its edges (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8501">#8501</a>)
(by <a
href="https://github.com/erenbati"><code>@​erenbati</code></a>)</li>
<li>Fix an unclosed disallowed tag in one attribution erasing the other
attributions, by sanitizing each attribution before joining them (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8569">#8569</a>)
(by <a href="https://github.com/sx4im"><code>@​sx4im</code></a>)</li>
<li>Fix <code>color-relief</code> with a <code>custom</code> DEM
encoding whose <code>redFactor</code>, <code>greenFactor</code> or
<code>blueFactor</code> is 0, where every elevation stop packed to NaN
and the color ramp collapsed (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/6411">#6411</a>)
(by <a
href="https://github.com/drakeo338"><code>@​drakeo338</code></a>)</li>
<li>Fix <code>queryRenderedFeatures</code> missing fill-extrusions on
globe once it renders as mercator (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8560">#8560</a>)
(by <a
href="https://github.com/birkskyum"><code>@​birkskyum</code></a>)</li>
<li>Fix <code>line-offset</code> distorting the line width around joins
(<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8570">#8570</a>)
(by <a href="https://github.com/HarelM"><code>@​HarelM</code></a>)</li>
<li>Cross-fade raster tiles when zooming out from a source's
<code>maxzoom</code>, where the tiles switched instantly (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/pull/8517">#8517</a>)
(by <a
href="https://github.com/cherenkov"><code>@​cherenkov</code></a>)</li>
<li>Mark a program as failed to create instead of throwing when the
WebGL context is lost or a failed link reports zero attached shaders,
where a dead GPU process made every query answer dead before
<code>webglcontextlost</code> arrived (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8607">#8607</a>)
(by <a
href="https://github.com/rubenmarcus"><code>@​rubenmarcus</code></a>)</li>
</ul>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/maplibre/maplibre-gl-js/commit/7976a989280508d763265f95f523e945d04d87b0"><code>7976a98</code></a>
Bump js version to 6.12.0 (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8646">#8646</a>)</li>
<li><a
href="https://github.com/maplibre/maplibre-gl-js/commit/7c6c49e604e0b1d42eea8ab9b74643dc254c41df"><code>7c6c49e</code></a>
fix: a gesture's hold on the center elevation waits for the DEM (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8548">#8548</a>)</li>
<li><a
href="https://github.com/maplibre/maplibre-gl-js/commit/48d5fffe6ba53017b393684200a86920df859e57"><code>48d5fff</code></a>
Draw fill outlines when terrain is enabled (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8632">#8632</a>)</li>
<li><a
href="https://github.com/maplibre/maplibre-gl-js/commit/d4aa8b469985583641c60d4cbc853eda3d7db1cf"><code>d4aa8b4</code></a>
feat: add a zoomToUserAccuracy option to GeolocateControl (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8324">#8324</a>)</li>
<li><a
href="https://github.com/maplibre/maplibre-gl-js/commit/94c71652d3ce7182aa8305cd0bd549d24e6fffe3"><code>94c7165</code></a>
test: build the terrain for the tile-zoom DEM read from the test util
(<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8645">#8645</a>)</li>
<li><a
href="https://github.com/maplibre/maplibre-gl-js/commit/c842c3bd6cf90288a4d7056304400ceb4b6465d1"><code>c842c3b</code></a>
Fix GeoJSONSource keeping every finished worker update alive while
updates ke...</li>
<li><a
href="https://github.com/maplibre/maplibre-gl-js/commit/80f9b4331f488915e5da9a2bb1e716a940b162de"><code>80f9b43</code></a>
fix: recalculate the matrices when the minimum elevation for the current
tile...</li>
<li><a
href="https://github.com/maplibre/maplibre-gl-js/commit/622371972d5e77a8688245026cd61dcfdfefbef1"><code>6223719</code></a>
fix: read the terrain elevation at the tile zoom where the drawn tiles
do not...</li>
<li><a
href="https://github.com/maplibre/maplibre-gl-js/commit/9c48bf7fb99d35888ea7ce943209786e59087be8"><code>9c48bf7</code></a>
fix: avoid a hole forming at the poles of the globe (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8638">#8638</a>)</li>
<li><a
href="https://github.com/maplibre/maplibre-gl-js/commit/1bc975fc97cc08eb87c6cb6f50e3e6f38dbf3bab"><code>1bc975f</code></a>
Add llms.txt and social cards to the docs (<a
href="https://redirect.github.com/maplibre/maplibre-gl-js/issues/8639">#8639</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/maplibre/maplibre-gl-js/compare/v6.11.2...v6.12.0">compare
view</a></li>
</ul>
</details>
<br />


[![Dependabot compatibility
score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=maplibre-gl&package-manager=npm_and_yarn&previous-version=6.11.2&new-version=6.12.0)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot show <dependency name> ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore this major version` will close this PR and stop
Dependabot creating any more for this major version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop
Dependabot creating any more for this minor version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop
Dependabot creating any more for this dependency (unless you reopen the
PR or upgrade to it yourself)


</details>

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-07 13:56:52 +00:00
2019-08-03 12:08:54 -04:00
2016-12-03 17:03:39 +01:00
2025-01-21 09:54:19 +01:00
2018-10-20 18:35:35 +02:00
2026-07-12 15:46:30 +03:00
2023-12-20 07:18:13 +02:00
2025-02-25 05:01:15 -05:00
2025-02-25 05:01:15 -05:00
2026-07-12 15:46:30 +03:00

Maputnik logo

Maputnik

GitHub CI status License

A free and open visual editor for the MapLibre GL styles targeted at developers and map designers.

Usage

docker run -it --rm -p 8888:8000 ghcr.io/maplibre/maputnik:main

To see the CLI options (for example file watching or style serving) run:

docker run -it --rm -p 8888:8000 ghcr.io/maplibre/maputnik:main --help

You might need to mount a volume (-v) to be able to use these options.

Documentation

The documentation can be found in the Wiki. You are welcome to collaborate!

Design Map from Scratch

Develop

Maputnik is written in typescript and is using React and MapLibre GL JS.

We ensure building and developing Maputnik works with the current active LTS Node.js version and above.

Check out our Internationalization guide for UI text related changes.

Getting Involved

Join 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.

Install the deps, start the dev server and open the web browser on http://localhost:8888/.

# install dependencies
npm install
# start dev server
npm run start

If you want Maputnik to be accessible externally use the --host option:

# start externally accessible dev server
npm run start -- --host 0.0.0.0

The build process will watch for changes to the filesystem, rebuild and autoreload the editor.

npm run build

Lint the JavaScript code.

# run linter
npm run lint
npm run lint-css
npm run sort-styles

Tests

End-to-end tests

For E2E testing we use Playwright. The tests live in the e2e directory and drive the app through the MaputnikDriver page object.

The first time you run the tests, install the browser:

npx playwright install chromium

Playwright automatically starts the dev server (npm run start) for you, so you can just run:

npm run test

Some useful options:

# see the tests run in a headed browser
npm run test -- --headed

# run a single spec / filter by title
npm run test -- e2e/map.spec.ts
npm run test -- -g "zoom level"

# open the interactive UI mode
npx playwright test --ui

Running the E2E tests also produces a code-coverage report in coverage/ (collected via istanbul instrumentation of the dev server).

Unit & component tests

Unit tests and component tests run with Vitest; component tests (*.browser.test.tsx) use Vitest's browser mode with the Playwright provider.

npm run test-unit

Release process

  1. Review CHANGELOG.md
    • Double-check that all changes included in the release are appropriately documented.
    • To-be-released changes should be under the "main" header.
    • Commit any final changes to the changelog.
  2. Run Create bump version PR 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.
  3. Once merged, an automatic process will kick in and creates a GitHub release and uploads release assets.

Sponsors

Thanks to the supporters of the Kickstarter campaign. This project would not be possible without these commercial and individual sponsors. You can see this file's history for previous sponsors of the original Maputnik repo. Read more about the MapLibre Sponsorship Program at https://maplibre.org/sponsors/.

License

Maputnik is licensed under MIT and is Copyright (c) Lukas Martinelli and Maplibre contributors. As 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.

S
Description
An open source visual editor for the 'Mapbox Style Specification'
Readme
302 MiB
Languages
JavaScript 88.5%
SCSS 9.3%
CSS 1.2%
HTML 0.9%
Dockerfile 0.1%