OpenLayers — Agent Skill 🌐🗺️

The authoritative AI coding standard for building modular, high-performance web mapping applications with OpenLayers and modern raster tile services.

Maintained by MapSnippets — Open-source geospatial snippets, guides, and agent tools.

⚡ Architectural Scope & Design Principles

• Native Library Focus: This skill focuses strictly on pure, native OpenLayers (ol/Map, ol/View, ol/layer/Tile, ol/source/XYZ, ol/layer/Vector, ol/source/Vector, ol/proj, ol/interaction/*). All generated code must use modular ES imports from the ol package.
• MapTiler as Data Source: MapTiler Cloud provides high-DPI raster XYZ tiles (512px @2x), geocoding, elevation, and static maps.
• Strictly Raster Basemaps: OpenLayers maps in this skill use native high-DPI raster basemaps (ol/layer/Tile + ol/source/XYZ) paired with rich client-side vector data layers (ol/layer/Vector + ol/source/Vector for GeoJSON, KML, GPX, digitization, clustering, and spatial analysis). For client-side vector tiles with MapLibre style JSON, use MapLibre GL JS instead.
• Architecture-First Reliability: OpenLayers is a modular GIS framework with built-in CAD interactions and strict projection transformations. Following lifecycle and projection contracts guarantees rock-solid execution.

🧭 How to Use This Skill — Mandatory Agent Workflow