@studiometa/vue-mapbox-gl

A small components library to use Mapbox GL in Vue 3.
228,734 170
Install
npm install @studiometa/vue-mapbox-gl
Latest Version:2.7.2
Vue:3
Older releases:2
License:GPL-3.0-or-later
Last Updated:Oct 19, 2026
Links: GitHub  ·  npm
Maintainer: jeremiewerner

🗺 @studiometa/vue-mapbox-gl

NPM Version Downloads Size Dependency Status Codecov

A small components library to use Mapbox GL in Vue 3 app.

Installation & usage

Have a look at the small guide for information on how to setup a simple map.

Components

The following components are available:

Component Description Doc.
MapboxMap Display a map with the given style. ✅
MapboxMarker Display a simple or custom marker. ✅
MapboxCluster Display a GeoJSON as clusters. ✅
MapboxGeocoder Display a geocoder search input with the @mapbox/mapbox-gl-geocoder plugin. ✅
MapboxImage Load an image to be used on the map. ✅
MapboxImages Load multiple images to be used on the map. ✅
MapboxLayer Display a layer on the map. ❌
MapboxNavigationControl Display the map's navigation controls ✅
MapboxPopup Display a popup on the map ✅
MapboxSource Load a source of data to be used on the map ❌

Contributing

Installation

# Clone the project
git clone git@github.com:studiometa/vue-mapbox-gl.git
# Cd in the repository
cd vue-mapbox-gl
# Install dependencies
npm i

Useful commands

# Build for deployment
npm run build
# Test before deployment
npm run test
# Lint files
npm run lint
# Fix linting errors
npm run fix

Note

This project is a rewrite of a fork of openearth/vue2mapbox-gl and is published under the GNU GPL 3 license.

Related Packages

Version History

Version Released License
2.7.2 GPL-3.0-or-later
2.7.1 GPL-3.0-or-later
2.7.0 GPL-3.0-or-later
2.6.0 GPL-3.0-or-later
2.5.0 GPL-3.0-or-later
Pre-releases (5)
Version Released License
2.7.0-alpha.3 GPL-3.0-or-later
2.7.0-alpha.0 GPL-3.0-or-later
2.0.0-alpha.0 GPL-3.0-or-later
1.1.0-beta.1 GPL-3.0-or-later
1.1.0-beta.0 GPL-3.0-or-later