mapbox-maps-ios

The Mapbox Maps SDK for iOS is a public library for displaying interactive, thoroughly customizable maps in native iOS. It takes map styles that conform to the Mapbox Style Specification, applies them to vector tiles that conform to the Mapbox Vector Tile Specification, and renders them using Metal.

Getting Started

This README is intended for developers who are interested in contributing to the Mapbox Maps SDK for iOS. Please visit https://docs.mapbox.com/ios/maps/guides/ for general information and instructions on using the Maps SDK in your iOS application.

[!IMPORTANT] CocoaPods support is being sunset by December 2026.

Mapbox plans to discontinue distributing the Maps SDK for iOS via CocoaPods by December 2026. After that date, no new releases will be published to CocoaPods and the existing podspec will no longer be maintained.

We strongly recommend migrating to Swift Package Manager (SPM), which is Mapbox's preferred and actively supported distribution channel for iOS. Please plan your migration ahead of the December 2026 deadline.

Examples App

The Examples app shows how to use many of the features in the Maps SDK. See the Examples project for more information.

Developing

If you are interested in contributing to the Maps SDK, please see the DEVELOPING.md file for information on setting up, running and building the SDK.

Reporting issues / Need help?

Report a bug :beetle:

Please use our bug template to report any issues with the Mapbox Maps SDK for iOS. We kindly ask you to avoid using the issue tracker in this repository for questions and instead use our support channels. See other questions below.

Request a new feature or enhancement :green_apple:

Please use our feature template to request new features or enhancements.

Other questions

If you have any questions about how to use the Mapbox platform, Mapbox Maps SDK for iOS, or if you need help with specific features, you can reach out to our support team via our website or connect with our developer community by joining our Discord channel.

Historical Note

This repository is a continuation of the Mapbox Maps SDK for iOS available at mapbox/mapbox-gl-native-ios.