Update to Mapbox

{
  "name": "mapbox-navigation-patterns",
  "description": "Navigation implementation patterns for turn-by-turn directions, route optimization, real-time traffic, multi-stop routing, and voice guidance across web, iOS, and Android platforms",
  "included_files": [
    {
      "relative_path": "AGENTS.md",
      "size_in_bytes": 14624
    },
    {
      "relative_path": "evals/evals.json",
      "size_in_bytes": 16875
    },
    {
      "relative_path": "references/android-navigation-sdk.md",
      "size_in_bytes": 21687
    },
    {
      "relative_path": "references/android-performance-antipatterns.md",
      "size_in_bytes": 22992
    },
    {
      "relative_path": "references/best-practices.md",
      "size_in_bytes": 4957
    },
    {
      "relative_path": "references/ios-navigation-sdk.md",
      "size_in_bytes": 18170
    },
    {
      "relative_path": "references/ios-navigation-specialized.md",
      "size_in_bytes": 7159
    },
    {
      "relative_path": "references/web-directions-api.md",
      "size_in_bytes": 11486
    }
  ],
  "skill_md_contents": "---\nname: mapbox-navigation-patterns\ndescription: Navigation implementation patterns for turn-by-turn directions, route optimization, real-time traffic, multi-stop routing, and voice guidance across web, iOS, and Android platforms\n---\n\n# Mapbox Navigation Patterns\n\nExpert guidance for implementing navigation and routing features using Mapbox Directions API and Navigation SDKs. Covers turn-by-turn navigation, route optimization, real-time traffic integration, multi-stop routing, and navigation UI components.\n\n## Use This Skill When\n\nUser says things like:\n\n- \"I need turn-by-turn navigation in my app\"\n- \"How do I add driving directions?\"\n- \"I want to show a route on the map\"\n- \"I need multi-stop routing\"\n- \"How do I add voice guidance?\"\n- \"I want real-time traffic updates\"\n- \"I need to optimize delivery routes\"\n\n## Product Overview\n\n### Directions API (REST)\n\n**Best for:** Web applications, simple routing, backend route calculation\n\n**Features:**\n\n- Route calculation (driving, walking, cycling, traffic)\n- Alternative routes\n- Turn-by-turn instructions\n- Multi-stop routing (up to 25 waypoints)\n- Route optimization\n- Real-time traffic data\n- Avoid specific roads/areas\n\n**Pricing:** Pay per request\n\n### Navigation SDK for iOS\n\n**Best for:** Native iOS apps with turn-by-turn navigation\n\n**Defaults:** SwiftUI app shell + wrap drop-in `NavigationViewController` via `UIViewControllerRepresentable` (official getting-started path). Use a fully custom Core UI ([CoreSDKExample](https://github.com/mapbox/mapbox-navigation-ios/tree/main/Examples/CoreSDKExample)) only when the user explicitly wants to build their own nav chrome.\n\n**Before coding:** SPM (`MapboxNavigationCore` + `MapboxNavigationUIKit`), `MBXAccessToken`, location permissions, background `audio`/`location` — see [install guide](https://docs.mapbox.com/ios/navigation/guides/install/) and the iOS reference checklist. Stable Core/UIKit releases do not need a `.netrc` download token.\n\n**Features:**\n\n- Drop-in turn-by-turn UI (`NavigationViewController`) — default\n- Optional fully custom Core UI (route progress / banner publishers)\n- Voice guidance (30+ languages)\n- Real-time rerouting\n- Traffic-aware routing\n- Offline maps and routing\n- Route progress tracking\n- Speed limit display\n\n**Pricing:** Monthly Active Users (MAU) based\n\n### Navigation SDK for Android\n\n**Best for:** Native Android apps with turn-by-turn navigation\n\n**Features:**\n\n- Complete turn-by-turn navigation UI\n- Voice guidance (30+ languages)\n- Real-time rerouting\n- Traffic-aware routing\n- Offline maps and routing\n- Custom UI components\n- Route progress tracking\n- Speed limit display\n\n**Pricing:** Monthly Active Users (MAU) based\n\n## Decision Guide\n\n### Choose Directions API when:\n\n- ✅ Web application\n- ✅ Simple route display (no turn-by-turn)\n- ✅ Backend route calculation\n- ✅ Route planning and optimization\n- ✅ Multi-stop routing\n- ✅ Don't need voice guidance\n\n### Choose Navigation SDK when:\n\n- ✅ Native mobile app (iOS/Android)\n- ✅ Need turn-by-turn navigation\n- ✅ Need voice guidance\n- ✅ Need navigation UI components\n- ✅ Need offline navigation\n- ✅ Need real-time rerouting\n- ✅ Building a navigation/delivery app\n\n## Implementation Patterns\n\n- **[references/web-directions-api.md](references/web-directions-api.md)** - Directions API patterns for the web: basic route display, turn-by-turn instructions, alternative routes, multi-stop routing, route optimization, and congestion-based route coloring\n- **[references/ios-navigation-sdk.md](references/ios-navigation-sdk.md)** - When: iOS turn-by-turn, setup, default SwiftUI + wrapped `NavigationViewController`, Core opt-in, example catalog\n- **[references/ios-navigation-specialized.md](references/ios-navigation-specialized.md)** - When: multi-stop, route line, camera, road cameras, route alerts, or `NavigationMapView` customization\n- **[references/android-navigation-sdk.md](references/android-navigation-sdk.md)** - Navigation SDK for Android: basic turn-by-turn navigation, custom navigation UI, route line rendering, maneuver arrows, navigation camera, voice guidance\n- **[references/android-performance-antipatterns.md](references/android-performance-antipatterns.md)** - Android Navigation SDK performance and correctness antipatterns: Native Route Object traversal costs, threading, memory/lifecycle leaks, route management correctness, frequent-callback rendering efficiency, and Coordination API lifecycle\n- **[references/best-practices.md](references/best-practices.md)** - Route caching, error handling, performance optimization, user experience, and common use cases (delivery routing, ride-sharing ETAs, walking/cycling directions)\n\n## Related Skills\n\n- **mapbox-search-integration**: Address search and geocoding\n- **mapbox-web-performance-patterns**: Optimizing navigation performance\n- **mapbox-ios-patterns**: iOS-specific integration patterns\n- **mapbox-android-patterns**: Android-specific integration patterns\n- **mapbox-token-security**: Securing your access tokens\n\n## Resources\n\n- [Directions API Documentation](https://docs.mapbox.com/api/navigation/directions/)\n- [Navigation SDK for iOS](https://docs.mapbox.com/ios/navigation/)\n- [Navigation SDK for Android](https://docs.mapbox.com/android/navigation/)\n- [Optimization API Documentation](https://docs.mapbox.com/api/navigation/optimization/)\n- [Map Matching API](https://docs.mapbox.com/api/navigation/map-matching/)\n- [Navigation Products Overview](https://docs.mapbox.com/help/getting-started/navigation/)\n\n## Quick Decision Guide\n\n**User says: \"I need directions\"**\n\n- Web app → Use Directions API\n- Mobile app → Use Navigation SDK\n\n**User says: \"I need turn-by-turn navigation\"**\n\n- iOS → Navigation SDK for iOS (SwiftUI + wrapped `NavigationViewController` by default; Core custom UI only if requested)\n- Android → Navigation SDK for Android\n- Web → Use Directions API + custom UI (no voice guidance)\n\n**User says: \"I need to optimize delivery routes\"**\n→ Use Optimization API (multi-stop route optimization)\n\n**User says: \"I need real-time traffic\"**\n→ Use `driving-traffic` profile with Directions API or Navigation SDK\n\n**User says: \"I need voice guidance\"**\n→ Must use Navigation SDK (iOS/Android only)\n\n**User says: \"Directions API or Navigation SDK?\"**\n→ Native turn-by-turn / voice → Navigation SDK (**MAU** pricing). Web / route display only → Directions API (**pay-per-request**).\n"
}