mapbox / mapbox/mapbox-navigation-ios-examples

Show how to bulid a Custom UI

Open
#37 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

new example
Dominant language
Swift
Stars
63
Forks
32
Avg merge
5m
Merged PRs (30d)
1

Description

If a developer does not want to use `NavigationViewController` and all of the pre-baked UI we bundle in the SDK, they should still be able to connect `CoreNavigation` to their own Custom UI.

This is a frequent request from developers that want to build custom turn-by-turn experiences, but none of our examples demonstrate how the key parts this type of implementation would work.

A new example that at the bare minimum demonstrates the following would be beneficial:

* How to retrieve instructions from `RouteProgress` and pass them to a Custom UI element
* How to trigger voice guidance when navigating with a Custom UI

cc: @mapbox/navigation-ios

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Review the existing Swift examples and the CoreNavigation, NavigationViewController, and RouteProgress APIs first. Add a custom-UI example showing how to retrieve route instructions and trigger voice guidance without the bundled UI; it is done when both flows are demonstrated.

Written by the indexing model from the issue text.

Assessment

Tech stack
swift
Domain
documentation, mobile
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.