maplibre-offline-map-manager
Manages offline-capable mapping with tile caching, location services, and MapLibre integration. Use when implementing map features, GPS tracking, offline map regions, or custom map styles in Purrsuit Mobile App.
When & Why to Use This Skill
The MapLibre Offline Map Manager is a specialized Claude skill designed to streamline the implementation of interactive, offline-capable maps in mobile applications. It provides standardized patterns for MapLibre integration, tile caching, and location services, allowing developers to quickly deploy robust mapping features including GPS tracking, geocoding, and custom map styling.
Use Cases
- Offline Navigation: Implementing map regions that users can download and access without an internet connection, ensuring reliability in remote areas.
- Location-Based Services: Integrating real-time GPS tracking and location permission handling for user-centric mobile features.
- Geocoding & Search: Converting coordinates into readable addresses and vice-versa to enhance location data presentation.
- Custom UI/UX Mapping: Quickly switching between custom map styles (Dark, Light, Satellite) and fitting map bounds to display specific data points or markers.
| name | maplibre-offline-map-manager |
|---|---|
| description | Manages offline-capable mapping with tile caching, location services, and MapLibre integration. Use when implementing map features, GPS tracking, offline map regions, or custom map styles in Purrsuit Mobile App. |
MapLibre Offline Map Manager
This skill handles MapLibre integration, offline tile management, and location services following the patterns established in the Purrsuit Mobile App.
When to Use This Skill
Use this skill when you need to:
- Implement interactive maps using MapLibre
- Handle GPS location tracking and permissions
- Manage offline map regions (download, delete, list)
- Switch between custom map styles (Liberty, Bright, Positron, Dark)
- Perform geocoding or reverse geocoding
- Fit map bounds to a collection of coordinates
Map Components
MapView with Camera
import { MapView, Camera, PointAnnotation } from "@maplibre/maplibre-react-native"
import { MAP_STYLES } from "@/services/offlineMapManager"
<MapView
ref={mapRef}
style={StyleSheet.absoluteFillObject}
mapStyle={MAP_STYLES[mapStyle].url}
>
<Camera
ref={cameraRef}
longitude={longitude}
latitude={latitude}
zoom={12}
/>
</MapView>
Point Annotations (Markers)
<PointAnnotation
id={encounter.id}
coordinate={[lng, lat]}
onSelected={() => handleMarkerPress(encounter.id)}
>
<View style={styles.marker}>
<Text>{emoji}</Text>
</View>
</PointAnnotation>
Offline Management
Downloading a Region
import { offlineMapManager } from "@/services/offlineMapManager"
await offlineMapManager.downloadRegion({
name: "Downtown SF",
bounds: [[-122.45, 37.8], [-122.4, 37.75]],
minZoom: 10,
maxZoom: 16
}, (status) => {
console.log(`Download progress: ${status.percentage}%`)
})
Location Services
Getting Current Location
import { getCurrentLocation, requestLocationPermissions } from "@/services/location"
const permission = await requestLocationPermissions()
if (permission.granted) {
const coords = await getCurrentLocation()
// { latitude, longitude, accuracy }
}
Reverse Geocoding
import { reverseGeocodeAsync, formatAddress } from "@/services/location"
const address = await reverseGeocodeAsync(lat, lng)
const displayString = formatAddress(address)
Advanced Patterns
Fitting Multiple Markers
const bounds = [minLng, minLat, maxLng, maxLat] // [W, S, E, N]
cameraRef.current?.fitBounds(bounds, {
padding: { top: 50, right: 50, bottom: 50, left: 50 },
duration: 1000,
})
Coordinate Conversion
import { toMapLibreCoords, fromMapLibreCoords } from "@/services/offlineMapManager"
const mapLibreCoord = toMapLibreCoords({ latitude, longitude }) // [lng, lat]
const nativeCoord = fromMapLibreCoords([lng, lat]) // { latitude, longitude }
References
See MAP_PATTERNS.md for detailed implementation examples.
See OFFLINE_STRATEGIES.md for tile caching and database management.