https://github.com/artembobkin/ImmersiveMap
Native Swift + Metal map rendering engine for SwiftUI apps.
https://github.com/artembobkin/ImmersiveMap
catalyst geospatial globe ios macos map-engine map-rendering mapbox maps metal mvt openstreetmap swift swift-package-manager swiftui terrain vector-tiles
Last synced: 4 days ago
JSON representation
Native Swift + Metal map rendering engine for SwiftUI apps.
- Host: GitHub
- URL: https://github.com/artembobkin/ImmersiveMap
- Owner: artembobkin
- License: mit
- Created: 2026-05-25T14:03:47.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-07-15T11:00:33.000Z (11 days ago)
- Last Synced: 2026-07-15T12:30:15.099Z (11 days ago)
- Topics: catalyst, geospatial, globe, ios, macos, map-engine, map-rendering, mapbox, maps, metal, mvt, openstreetmap, swift, swift-package-manager, swiftui, terrain, vector-tiles
- Language: Swift
- Size: 109 MB
- Stars: 33
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Support: SUPPORT.md
Awesome Lists containing this project
- awesome-swiftui-libraries - ImmersiveMap - A native Swift + Metal vector-tile map engine for SwiftUI with a 3D globe, starfield and labels (Map / Content)
- awesome-vector-tiles - ImmersiveMap - A Metal-rendered Mapbox Vector Tile map engine for SwiftUI with a 3D globe and flat map, for iOS and macOS. (Clients)
README
# ImmersiveMap
[](https://github.com/artembobkin/ImmersiveMap/actions/workflows/ci.yml) [](https://swiftpackageindex.com/artembobkin/ImmersiveMap) [](https://swiftpackageindex.com/artembobkin/ImmersiveMap) [](https://github.com/artembobkin/ImmersiveMap/tags) [](LICENSE)
Native Swift + Metal map rendering engine for SwiftUI apps.
> **Status: early alpha.** The public API is not stable yet. Not production-ready. Not a drop-in replacement for Mapbox, MapLibre, or MapKit.
ImmersiveMap is a **native Swift + Metal map rendering engine for SwiftUI** apps on Apple platforms.
It is built for developers who want direct control over map rendering, their own vector tile data, globe rendering, and a native engine they can extend to fit their app.
## Requirements
- Swift 6.0+
- Xcode 16+
- iOS 18+
- macOS 15+ (native AppKit, not Mac Catalyst)
- Metal-capable device or simulator
## Installation
ImmersiveMap is available on the [Swift Package Index](https://swiftpackageindex.com/artembobkin/ImmersiveMap).
Add ImmersiveMap as a Swift Package dependency:
```text
https://github.com/artembobkin/ImmersiveMap.git
```
Or in Xcode:
1. Open your project.
2. Select **File → Add Package Dependencies…**
3. Paste the repository URL.
4. Add the `ImmersiveMap` library to your app target.
## Quick Start
```swift
import SwiftUI
import ImmersiveMap
struct ContentView: View {
@State private var camera = ImmersiveMapCameraController()
var body: some View {
ImmersiveMapView()
.cameraController(camera)
.enableCameraUIControls()
.ignoresSafeArea()
}
}
```
ImmersiveMap ships with a built-in tile provider, so the snippet above renders a map out of the box - no token or account required. The same SwiftUI code runs natively on iOS (UIKit host) and macOS (AppKit host): `ImmersiveMapView` bridges to the platform view internally.
To use Mapbox vector tiles instead, attach a provider and style:
```swift
ImmersiveMapView()
.tileProvider(MapboxTileProvider(accessToken: "your-mapbox-public-token"))
.mapStyle(MapboxMapStyle())
// camera and other modifiers...
```
## Features
| Feature | Status |
|---|---|
| SwiftUI integration | Alpha |
| Native iOS (UIKit host) | Alpha |
| Native macOS (AppKit host, no Catalyst) | Alpha |
| Native Metal renderer | Alpha |
| Mapbox vector tiles | Alpha |
| Globe rendering | Alpha |
| Labels | Alpha |
| [Avatars / live markers](Documentation/docs/markers.md) | Alpha |
| Disk / memory tile cache | Alpha |
| Offline maps | Planned |
| 3D Tiles | Planned |
| Stable public API | Not yet |
| Production readiness | Not yet |
## Example Apps
The repository includes two host apps that reference the package locally:
- `ImmersiveMapIOS` - iOS demo app
- `ImmersiveMapMac` - native macOS demo app (AppKit, not Catalyst)
To run:
1. Clone the repository.
2. Open `ImmersiveMap.xcworkspace`.
3. Select the `ImmersiveMapIOS` or `ImmersiveMapMac` scheme.
4. Build and run.
Both demo apps render the built-in tile provider out of the box, so they run with no token or account. To try the Mapbox provider instead, attach it to the app's `ImmersiveMapView` as shown in [Quick Start](#quick-start).
## Known Limitations
- Early alpha; the public API may change.
- Not production-ready yet.
- Not a drop-in replacement for Mapbox, MapLibre, or MapKit.
- Currently focused on Apple platforms.
- Requires Metal.
- Tile provider terms and attribution are the responsibility of the app developer.
- Performance characteristics are still being measured.
## Attribution and Tile Provider Terms
ImmersiveMap is MIT-licensed, but map tiles, styles, and geospatial datasets may have their own licenses and attribution requirements. When using Mapbox or other providers, make sure your app follows their terms and attribution rules.
## Contributing
ImmersiveMap is currently maintained as a single-maintainer project. Issues and feedback are welcome. Pull requests are accepted for documentation, examples, bug fixes, and tests. See [CONTRIBUTING.md](CONTRIBUTING.md).
Bug reports and feature requests belong in [Issues](https://github.com/artembobkin/ImmersiveMap/issues). Questions, ideas, and anything open-ended belong in [Discussions](https://github.com/artembobkin/ImmersiveMap/discussions).
## License
ImmersiveMap is available under the MIT license. See [LICENSE](LICENSE).
## Commercial Support
I am available for consulting and custom ImmersiveMap integrations.
To get in touch, start a [discussion](https://github.com/artembobkin/ImmersiveMap/discussions).
## Screenshots
