mapbox-style-patterns
Common style patterns, layer configurations, and recipes for typical mapping scenarios including restaurant finders, real estate, data visualization, navigation, delivery/logistics, and more. Use when implementing specific map use cases or looking for proven style patterns.
By mapbox · 1,940 installs
npx skills add mapbox/mapbox-agent-skills --skill mapbox-style-patterns
Source repository · Upstream listing
Mapbox Style Patterns Skill
This skill provides battle tested style patterns and layer configurations for common mapping scenarios.
Pattern Library
Pattern 1: Restaurant/POI Finder
Use case: Consumer app showing restaurants, cafes, bars, or other points of interest
Visual requirements:
POIs must be immediately visible
Street context for navigation
Neutral background (photos/content overlay)
Mobile optimized
Recommended layers:
Key features:
Desaturated base map (doesn't compete with photos)
High contrast markers ( FF6B35 orange stands out)
Clear road network (white on light gray)
Parks visible but subtle
Text halos for readability
Pattern Selection Guide
Decision Tree
Question 1: What is the primary content?
User generated markers/pins POI Finder Pattern
Property data/boundaries Real Estate Pattern
Statistical/analytical data Data Visualization Pattern
Routes/directions Navigation Pattern
Real time tracking/delivery zones Delivery/Logistics Pattern (customer markers should include a pulse animation via second circle layer + requestAnimationFrame + setPaintProperty; see references/delivery logistics.md)
Question 2: What is the viewing environment?
Daytime/office Light theme
Night/dark environment Dark Mode Pattern
Variable Provide theme toggle
Question 3: What is the user's primary action?
Browse/explore Focus on POIs, rich detail
Navigate Focus on roads, route visibility
Track delivery/logistics Real time updates, zones, status
Analyze data Minimize base map, maximize data
Select location Clear boundaries, context
Question 4: What is the platform?
Mobile Simplified, larger touch targets, less detail
Desktop Can include more detail and complexity
Both Design mobile first, enhance for desktop
Layer Optimization Patterns
Performance Pattern: Simplified by Zoom
Reference Files
Additional patterns and configurations are available in the references/ directory. Load the relevant file when a specific pattern is needed.
File Contents
[references/real estate.md](references/real estate.md) Pattern 2: Real Estate Map property boundaries, price color coding, amenity markers
[references/data viz base.md](references/data viz base.md) Pattern 3: Data Visualization Base Map minimal grayscale base for choropleth/heatmap overlays
[references/navigation.md](references/navigation.md) Pattern 4: Navigation/Routing Map route display, user location, turn arrows
[references/dark mode.md](references/dark mode.md) Pattern 5: Dark Mode / Night Theme near black background, reduced brightness
[references/delivery logistics.md](references/delivery logistics.md) Pattern 6: Delivery/Logistics Map real time tracking, zones, driver markers, ETA badges
[references/expressions clustering.md](references/expressions clustering.md) Data driven expression patterns + clustering for dense POIs
[references/common modifications.md](references/common modifications.md) 3D Buildings, Terrain/Hillshade, Custom Markers
Loading instructions: Read the reference file that matches the user's use case. For example, if implementing a delivery tracking map, load references/delivery logistics.md .
Testing Patterns
Visual Regression Checklist
[ ] Test at zoom levels: 4, 8, 12, 16, 20
[ ] Verify on mobile (375px width)
[ ] Verify on desktop (1920px width)
[ ] Test with dense data
[ ] Test with sparse data
[ ] Check label collision
[ ] Verify color contrast (WCAG)
[ ] Test loading performance
When to Use This Skill
Invoke this skill when:
Starting a new map style for a specific use case
Looking for layer configuration examples
Implementing common mapping patterns
Optimizing existing styles
Need proven recipes for typical scenarios
Debugging style issues
Learning Mapbox style best practices