mapbox-style-patterns

This skill is a library of battle-tested Mapbox style patterns, layer configurations, and recipes for common mapping scenarios. It solves the problem of choosing and configuring the right map layers and styling for a given use case — restaurant/POI finders, real estate, data visualization, navigation, and delivery/logistics — by providing proven, copy-ready configurations rather than requiring designers to build them from scratch.

The primary document presents a pattern library (starting with a POI finder using a desaturated base map, high-contrast markers, and clear road hierarchy) plus a decision tree that selects a pattern based on primary content, viewing environment, user action, and platform. A companion AGENTS.md quick reference covers Mapbox layer types, data-driven styling with match/interpolate/case expressions, zoom-based styling, clustering, feature-state hover and selection, filters, and math/string expressions. It also documents performance patterns (vector tiles versus GeoJSON, minzoom/maxzoom, combining layers, feature state over remove/re-add), dynamic style updates, layer ordering, common use cases like choropleths, routes, and 3D buildings, and debugging tips. Additional reference files exist for dark mode, navigation, real estate, clustering expressions, and delivery/logistics.

It targets frontend and GIS developers building interactive maps with Mapbox GL. It is a read-only reference and recipe collection with no runtime credential handling or destructive behavior.