maplibre-tile-sources

Configure MapLibre GL JS data sources and styles with glyphs and sprites.

77|3|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/FlorianBruniaux/starmapper --skill maplibre-tile-sources-florianbruniaux
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maplibre-tile-sources
Source: https://github.com/FlorianBruniaux/starmapper/tree/main/.agents/skills/maplibre-tile-sources
Command: npx skills add https://github.com/FlorianBruniaux/starmapper --skill maplibre-tile-sources-florianbruniaux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

MapLibre GL JS relies on external data sources and styles; this Skill guides you through choosing data sources (GeoJSON, vector tiles, server-hosted tiles, PMTiles) and ensuring glyphs, sprites, and tile schemas are properly configured so maps render correctly.

Core Features & Use Cases

  • Decide between GeoJSON, vector tiles, hosted tile services, self-hosted tile servers, or PMTiles based on dataset size and deployment constraints.
  • Configure glyphs and sprites to render labels and icons consistently across maps.
  • Debug common issues like blank maps, missing tiles, and schema mismatches, and migrate from Mapbox to MapLibre.

Quick Start

Create a MapLibre style that references a data source (GeoJSON or vector tiles) and configure glyphs and sprites for labels and icons.

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 vector tile sources in a MapLibre style?

Configure vector tile sources in MapLibre by defining source objects in the style JSON, specifying the tile URL, and ensuring layers reference those sources. You can use hosted tile services, self-hosted tile servers, or PMTiles depending on dataset size and deployment constraints.

What is the best way to choose between GeoJSON and vector tiles for MapLibre?

Choosing between GeoJSON and vector tiles for MapLibre depends on dataset size and deployment constraints. GeoJSON suits smaller datasets loaded directly in the browser, while vector tiles, hosted or self-hosted, optimize performance for larger geographic data.

Why does my MapLibre map render blank, and how do I debug missing tiles?

A blank MapLibre map often indicates missing tiles, schema mismatches, or incorrect source configuration. Debug by verifying that your style structure includes valid sources, layers, glyphs, and sprite URLs, and check that the tile schema matches your layer definitions.

Do I need to configure glyphs and sprites to display labels and icons in MapLibre?

Yes, you need to configure glyphs and sprites to render labels and icons consistently in MapLibre. Your style JSON must include valid URLs for glyph PBF ranges and sprite sheets so the renderer can load text fonts and point icons.

How do I migrate from Mapbox to MapLibre data sources and styles?

Migrating from Mapbox to MapLibre involves updating your style JSON to replace Mapbox-specific tile URLs and access tokens with compatible sources. You must ensure the resulting structure has valid sources, layers, glyphs, and sprite URLs for MapLibre rendering.

Can I use PMTiles as a data source in a MapLibre style?

Yes, you can use PMTiles as a data source in a MapLibre style. PMTiles provides an efficient single-file archive format for vector tiles, serving as a self-hosted alternative that integrates into your source configuration without requiring a dedicated tile server.