# MapLibre GL JS
[](LICENSE.txt) [](https://www.npmjs.com/package/maplibre-gl) [](https://github.com/maplibre/maplibre-gl-js/actions/workflows/ci.yml) [](https://opensource.org/licenses/BSD-3-Clause) [](https://codecov.io/gh/maplibre/maplibre-gl-js)
**[MapLibre GL JS](https://maplibre.org/maplibre-gl-js/docs/API/)** is an open-source library for publishing maps on your websites or webview based apps. Fast displaying of maps is possible thanks to GPU-accelerated vector tile rendering.
It originated as an open-source fork of [mapbox-gl-js](https://github.com/mapbox/mapbox-gl-js), before their switch to a non-OSS license in December 2020. The library's initial versions (1.x) were intended to be a drop-in replacement for the Mapbox’s OSS version (1.x) with additional functionality, but have evolved a lot since then.
## Getting Started
Include the JavaScript and CSS files in the `` of your HTML file.
``` html
```
Include the following code in the `` of your HTML file.
``` html
```
Enjoy the map!
## Documentation
Full documentation for this library [is available here](https://maplibre.org/maplibre-gl-js/docs/API/).
Check out the features through [examples](https://maplibre.org/maplibre-gl-js/docs/examples/).
| Showcases | |
| ---- | ---- |
| | |
| | |
| | |
## Migrating from mapbox-gl to maplibre
The libraries are very similar but diverge with newer features happening from v2 in both libraries where Mapbox turned proprietary.
The overall migration happens by uninstalling `mapbox-gl` and installing `maplibre-gl` in your node packages (or see below for CDN links), and replacing `mapboxgl` with `maplibregl` throughout your TypeScript, JavaScript and HTML/CSS.
```diff
- var map = new mapboxgl.Map({
+ var map = new maplibregl.Map({
-