https://github.com/ably/asset-tracking-ios-customer-app-demo

Incubating.
https://github.com/ably/asset-tracking-ios-customer-app-demo

asset-tracking demo

Last synced: about 20 hours ago
JSON representation

Incubating.

• Host: GitHub
• URL: https://github.com/ably/asset-tracking-ios-customer-app-demo
• Owner: ably
• License: apache-2.0
• Created: 2022-05-30T14:39:52.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-09-10T07:40:20.000Z (about 2 years ago)
• Last Synced: 2023-04-03T10:36:49.225Z (over 1 year ago)
• Topics: asset-tracking, demo
• Language: Swift
• Homepage:
• Size: 391 KB
• Stars: 0
• Watchers: 27
• Forks: 1
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Ably Asset Tracking Demo: iOS Customer

_[Ably](https://ably.com) is the platform that powers synchronized digital experiences in realtime. Whether attending an event in a virtual venue, receiving realtime financial information, or monitoring live car performance data – consumers simply expect realtime digital experiences as standard. Ably provides a suite of APIs to build, extend, and deliver powerful digital experiences in realtime for more than 250 million devices across 80 countries each month. Organizations like Bloomberg, HubSpot, Verizon, and Hopin depend on Ably’s platform to offload the growing complexity of business-critical realtime data synchronization at global scale. For more information, see the [Ably documentation](https://ably.com/documentation)._

## Overview

This demo presents a mock customer-facing app with functionality matching that expected for the typical use case for

[Ably's Asset Tracking solution](https://ably.com/solutions/asset-tracking),

being the tracking of a delivery being made to that customer, where that customer is using an iOS based device such as an iPhone or an iPad.

Such deliveries could be food, groceries or other packages ordered for home delivery.

This app is a member of our

[suite of **Ably Asset Tracking Demos**](https://github.com/ably/asset-tracking-demos),

developed by Ably's SDK Team to demonstrate best practice for adopting and deploying Asset Tracking.

## Status

The demo app is currently under active development and constantly improved. We're currently working on the first milestone of the [Milestones list](https://github.com/ably/asset-tracking-demos/blob/main/app-requirements.md), but most of the basic functionality of the expected use cases can already be tested.

## Requirements

Xcode 13.4+ is recommended. It's not tested in any previous version. App can be run on iOS devices with iOS >= 14.0.

## Usage

### Basic setup and running the app

- To run the app you'll first need to configure your Mapbox account and credentials. Please follow [the guide](https://docs.mapbox.com/ios/search/guides/install/#configure-credentials).

- You'll need a `Secrets.plist` file containing Mapbox Access Token and the Ably API Key. To do this you can rename the `Secrets.plist.example` file at the root of the project, and fill it out with your data.

- `MAPBOX_ACCESS_TOKEN`: Used to access Mapbox Navigation SDK/APIs, and can be taken from [here](https://account.mapbox.com/).

- `BACKEND_URL`: Backend URL used by the app to authenticate with Ably. For more details, see [Ably Asset Tracking Backend Demo](https://github.com/ably/asset-tracking-backend-demo).

## Resources

- [Asset Tracking Documentation](https://ably.com/docs/asset-tracking)

- [Ably Documentation](https://ably.com/docs)