diff --git a/2. Install, Configure, and Run the Mobile App (iOS).md b/2. Install, Configure, and Run the Mobile App (iOS).md new file mode 100644 index 0000000..b58700b --- /dev/null +++ b/2. Install, Configure, and Run the Mobile App (iOS).md @@ -0,0 +1,75 @@ +# How to securely install and run the Lastmiler mobile app + +## Prerequisites + +Your iPhone should be running at least iOS 12.0. We recommend using the latest version available (currently iOS 18). To check your iOS version go to `Settings > General > About > iOS Version`. If a system update is available, install it via `Settings > General > Software Update`. + +Ensure your device is signed in and has access to the **App Store**. + +## The installation + + + +1. Start the **"App Store"** +2. Select top search bar +3. Search for **"lastmiler"** + + + +1. Select the Lastmiler App in the results list +2. Start installation +3. Wait for installation to complete, then tap **"Open"** + *(You can also find the app on the home screen or using Spotlight Search)* + + +## Using the App for the first time + + + +Make sure the Lastmiler App is open and that the login page is displayed. + +1. Enter your **Email** and **Password**, then tap **"Login"** +2. Tap **"Tracking"** in the main menu +3. Tap the **"Start Tracking"** button at the bottom of the screen + +## Configuration of the App + + + +When starting tracking for the first time, respond to the following prompts: + +1. For **"Background Locations Access"**, tap **"I understand"** +2. For **"Allow Lastmiler to access this device's location?"**, tap **"While using the app"** +3. For **"Allow Lastmiler to also use your location even when you are not using the app?**", tap **"Change to Always Allow"** +4. For **"Lastmiler Would Like to Access Your Motion & Fitness Activity"**, tap **"Allow"** + + +## Running the App + +Once configured, run the Lastmiler App and begin tracking: + + + +1. Tap **"Stop Tracking"** to end tracking + *(Location data is uploaded to the cloud automatically)* + +2. Tap **"My Active Maps"** to view available maps + + + +- Tap on a map to view it +- Red lines show tracked progress +- A blue dot indicates your live position if in the area + +You may now leave the app running in the background. + + + +**The Location indicator icon must remain active and visible at the top of your screen at all times.** + +## Important notes + +- All configuration steps must be completed to ensure Notifications, Location access, Physical activity access, Battery usage, and Background activity are enabled. +- While using the app, the Location icon must be visible in the status bar. If it disappears or is disabled, tracking is not working. +- Do not use **Power Saving Mode** while tracking. It may cause the app to stop running in the background. +- Do not activate any **Battery Optimization** prompts during app usage. These may stop background tracking over time.