maplibre-mapbox-migration

Migrate Mapbox GL JS apps to MapLibre GL JS with API and asset updates.

131|8|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/maplibre/maplibre-agent-skills --skill maplibre-mapbox-migration-maplibre
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maplibre-mapbox-migration
Source: https://github.com/maplibre/maplibre-agent-skills/tree/main/skills/maplibre-mapbox-migration
Command: npx skills add https://github.com/maplibre/maplibre-agent-skills --skill maplibre-mapbox-migration-maplibre

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrates Mapbox GL JS apps to MapLibre GL JS, addressing API changes and asset sources, and helping teams avoid vendor lock-in.

Core Features & Use Cases

  • Migrate existing Mapbox GL JS applications to MapLibre GL JS with minimal code changes.
  • Understand compatibility, API changes, and open-source alternatives for long-term maintenance.
  • Replace Mapbox styles and tile sources with non-Mapbox equivalents, update plugins, and ensure a smooth transition.

Quick Start

Install maplibre-gl, update imports and namespace from mapboxgl to maplibregl, remove mapboxgl.accessToken, and switch style URLs from mapbox://styles to non-Mapbox sources.

Frequently Asked Questions about maplibre-mapbox-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate a Mapbox GL JS app to MapLibre GL JS?

To migrate a Mapbox GL JS app to MapLibre GL JS, install the maplibre-gl package, update imports from mapboxgl to maplibregl, remove mapboxgl.accessToken, and switch mapbox://styles URLs to non-Mapbox sources.

Do I need a Mapbox access token when using MapLibre GL JS?

No, you do not need a Mapbox access token when using MapLibre GL JS. Migrating requires removing the mapboxgl.accessToken configuration and replacing Mapbox tile sources with compatible open-source alternatives.

What are the breaking API changes when moving from Mapbox GL JS to MapLibre GL JS?

Breaking API changes when moving from Mapbox GL JS to MapLibre GL JS involve updating import namespaces from mapboxgl to maplibregl, replacing Mapbox styles, and finding compatible plugins for the new environment.

What are the best open-source tile sources to replace Mapbox styles after migration?

To replace Mapbox styles after migration, you must switch style URLs from mapbox://styles to non-Mapbox equivalents and find compatible open-source tile sources that ensure a smooth transition without vendor lock-in.

Are Mapbox GL JS plugins compatible with MapLibre GL JS?

Mapbox GL JS plugins may require updates for MapLibre GL JS compatibility. Evaluating open-source alternatives and finding compatible plugins is a necessary step to ensure a smooth transition during migration.

Why migrate from Mapbox GL JS to an open-source alternative like MapLibre?

Migrating from Mapbox GL JS to MapLibre GL JS addresses API changes and asset sources while helping teams avoid vendor lock-in and ensure long-term maintenance with open-source alternatives.