maplibre-tile-sources

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

MapLibre GL JS relies on external sources for map data. This skill guides you in choosing the right data source type (GeoJSON, PMTiles, hosted tile services, or self-hosted tile servers) and in configuring the corresponding glyphs and sprite to ensure labels and icons render correctly.

Core Features & Use Cases

  • Guidance on when to use GeoJSON vs vector tiles, and how to mix sources for basemaps and overlays.
  • How to configure glyphs and sprites and understand tile schemas (OpenMapTiles, Shortbread, Protomaps).
  • Includes guidance for migrating from Mapbox and debugging blank maps or missing tiles.

Quick Start

Build a MapLibre style by selecting a data source type and ensuring glyphs and sprites are wired to the style.

Frequently Asked Questions about maplibre-tile-sources

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

FAQPage Schema
How do I configure data sources in MapLibre GL JS?

Configuring MapLibre data sources involves selecting a type like GeoJSON, PMTiles, hosted tile services, or self-hosted tiles, then wiring corresponding glyphs and sprites to your style to ensure labels and icons render correctly.

When should I use GeoJSON vs vector tiles in MapLibre?

Use GeoJSON for small datasets like store locators and vector tiles or PMTiles for larger scale basemaps. You can mix sources in MapLibre, using vector tiles for the basemap and GeoJSON for interactive overlays.

What tile schemas work with MapLibre data sources?

MapLibre supports tile schemas including OpenMapTiles, Shortbread, and Protomaps. Selecting a schema determines how vector layers are structured and styled within your MapLibre style configuration.

How do I fix blank maps or missing tiles in MapLibre?

To fix blank maps in MapLibre, verify data source URLs, check tile format compatibility, and ensure glyphs and sprites are correctly referenced and accessible in your style configuration.

Can I migrate from Mapbox to MapLibre and keep my tile sources?

Yes, you can migrate from Mapbox to MapLibre while retaining your tile sources by updating your style configuration to point to MapLibre-compatible data sources, glyphs, and sprites.

Do I need self-hosted tiles for a MapLibre store locator app?

You do not need self-hosted tiles for a MapLibre store locator. GeoJSON is often sufficient for points of interest at this scale, layered over a hosted tile service or PMTiles basemap.