maplibre-tile-sources

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

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/cogidoo/sunchaser --skill maplibre-tile-sources-cogidoo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maplibre-tile-sources
Source: https://github.com/cogidoo/sunchaser/tree/main/.agents/skills/maplibre-tile-sources
Command: npx skills add https://github.com/cogidoo/sunchaser --skill maplibre-tile-sources-cogidoo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

MapLibre GL JS requires you to decide how data is sourced and delivered. This Skill guides you through selecting and configuring data sources — GeoJSON, PMTiles, hosted tile services, or self-hosted tile servers — and ensures you also configure glyphs and sprites for labels and icons.

Core Features & Use Cases

  • Source selection: Choose between GeoJSON, PMTiles, hosted tiles, or self-hosted tile servers.
  • Glyphs & Sprites: Configure fonts and icons for labels and map symbols.
  • Tile schema compatibility: Ensure style sources match the tile data schema (OpenMapTiles, Shortbread, Protomaps).
  • Use Case: Rapidly prototype maps with different data delivery modes and migrate from other platforms.

Quick Start

Assess your dataset size and select the appropriate MapLibre data source (GeoJSON, PMTiles, hosted tiles, or self-hosted tiles) to begin configuring the map.

Frequently Asked Questions about maplibre-tile-sources

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

FAQPage Schema
How do I choose between GeoJSON, PMTiles, and hosted vector tiles for MapLibre?

To configure MapLibre tile sources, choose GeoJSON for small overlays, PMTiles for static hosting efficiency, or hosted and self-hosted tile servers for global vector tiles. Assessing dataset size determines the appropriate data delivery mode.

What's the best way to configure glyphs and sprites in a MapLibre style JSON?

Configuring MapLibre glyphs and sprites requires setting the correct URLs in the style JSON sources. This ensures fonts and icons are properly delivered for rendering map labels and symbols across all active tile sources.

How do I ensure my MapLibre style sources match the tile data schema?

To match MapLibre style sources with tile data schemas, verify compatibility with standard schemas like OpenMapTiles, Shortbread, or Protomaps. Ensuring style sources align with the underlying tile schema prevents rendering errors.

Can I use PMTiles with MapLibre GL JS for client-side web maps?

PMTiles can be used with MapLibre GL JS for client-side web maps as a static tile delivery option. It allows efficient rendering across scales without requiring a dedicated hosted tile service or self-hosted server backend.

Why does my MapLibre map fail to render vector tiles from a self-hosted server?

MapLibre vector tiles from a self-hosted server fail to render when style JSON sources are misconfigured or tile schema compatibility issues exist. Verify CORS considerations, glyph and sprite URLs, and ensure the tile schema matches.

When do I need to configure CORS considerations for MapLibre tile sources?

CORS considerations for MapLibre tile sources must be configured when fetching data from hosted tile services or self-hosted servers. Proper CORS headers ensure browsers permit loading vector tiles, glyphs, and sprites across origins.