skills.rest
JNZader
JNZaderCOMMUNITY
Explore all skills by this author →
GitHub

maplibre-mapbox-migration

Migrate Mapbox GL JS apps to MapLibre GL JS by updating packages, imports, and style sources.

Updated Feb 5, 2026
Search Tags:#migration#open-source#maplibre#mapbox#gl-js#style-migration#web-maps
One-click install
npx skills add https://github.com/JNZader/consorcio-canalero --skill maplibre-mapbox-migration
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maplibre-mapbox-migration
Source: https://github.com/JNZader/consorcio-canalero/tree/main/.codex/skills/maplibre-mapbox-migration
Command: npx skills add https://github.com/JNZader/consorcio-canalero --skill maplibre-mapbox-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a guided pathway to migrate an application from Mapbox GL JS to MapLibre GL JS, covering package, import, token, and style source changes to eliminate Mapbox dependencies.

Core Features & Use Cases

  • Package and import updates: switch from mapbox-gl to maplibre-gl and adjust imports/CSS.
  • Token and style migration: remove Mapbox access tokens and replace mapbox:// style URLs with non-Mapbox sources.
  • Tile source flexibility: select open or self-hosted tile sources and adapt to MapLibre style spec.
  • Plugin and API adaptation: swap to compatible MapLibre plugins and equivalent APIs for geocoding/directions as needed.

Quick Start

Install maplibre-gl, update imports and CSS from mapbox-gl to maplibre-gl, and replace style URLs with 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?▼

Migrate Mapbox GL JS apps to MapLibre GL JS by swapping the mapbox-gl package for maplibre-gl, updating imports and CSS, and removing access tokens. Replace mapbox:// style URLs with compatible non-Mapbox tile sources to complete the transition.

Do I need an access token to use MapLibre GL JS?▼

No access token is required for MapLibre GL JS. The migration process explicitly removes Mapbox access tokens, allowing you to load maps using open or self-hosted tile sources without token authentication dependencies.

How do I update mapbox style URLs for MapLibre migration?▼

Update mapbox style URLs by replacing mapbox:// references with non-Mapbox sources. Select open or self-hosted tile sources and adapt the style definitions to ensure full compatibility with the MapLibre style specification.

Can I use Mapbox plugins and APIs with MapLibre?▼

Direct Mapbox plugins require adaptation for MapLibre. Swap incompatible plugins for compatible MapLibre alternatives and use equivalent APIs for functionalities like geocoding or directions to maintain application behavior.

What are the limitations of migrating from Mapbox to MapLibre GL JS?▼

Limitations involve validating compatibility with the MapLibre style specification and ensuring equivalent APIs exist for specific Mapbox plugins. Custom tile sources must be manually configured to replace removed mapbox:// dependencies.

Does MapLibre GL JS support custom tile sources?▼

Yes, MapLibre GL JS supports custom tile sources. During migration, you can select open or self-hosted tile sources to replace Mapbox dependencies, ensuring the map loads correctly without requiring an access token.

Related Skills

Explore More Software Engineering Skills→
YlopoYlopo

mapbox-maplibre-migration

Guide migration from MapLibre GL JS to Mapbox GL JS with API compatibility and token setup.

Official
Intermediate
mapboxmapbox
72

mapbox-maplibre-migration

Migrate MapLibre GL JS projects to Mapbox GL JS with API and token alignment.

Official
Intermediate
cogidoocogidoo

maplibre-tile-sources

Configure MapLibre GL JS data sources, glyphs, sprites, and tile schemas.

Community
Intermediate
YlopoYlopo

mapbox-web-integration-patterns

Integrate Mapbox GL JS maps across React, Vue, Svelte, Angular, and Next.js.

Official
Advanced