App Testing Instructions

1. Adding Internal Testers

Only email addresses added to your developer accounts will be able to test the app on their device. This setup only needs to be done once.

Google Play Console

📌 Make sure testers' devices are signed in with the same Google account added to the tester list — this is required for Android testing.

1. Open your Google Play Console account.

2. Click on your app.

   📌 The app must already be created in your account by the Locatify team before this step is available.

3. Navigate to Test and release in the left menu, then click Internal testing.
4. Click Testers, then Create email list.
5. Name the list (e.g., your app's name + "testers"). You'll also see a "Locatify testers" list — this is Locatify's internal testing team, no action needed there.
6. Scroll down to find the testing link — this is what you'll share with your testers list. (Our team will also send you this link by email.) The same link can be shared with everyone on the list.

Apple Developer Account

1. Open your Apple Developer account.

2. Click on your app.

   📌 The app must already be created by the Locatify team before this step is available.

3. Click the TestFlight tab.
4. In the left column, click Internal Testing.
5. Add your list of internal testers.
6. Share the TestFlight testing link with them.

2. Testing Channels

Android — APK Installation
APK distribution is used when the Google Developer account isn't ready yet — it lets testing begin without waiting on account access, which is why Android builds are usually the first ready for testing.

1. Open the APK link directly on your Android device.
2. Follow the installation instructions on screen (Android may run a security scan first).
3. Install and open the app.

The app installs directly on your device, without going through the Play Store.

⚠️ Important: Before installing a new APK build, uninstall the previous version first (device menu → select the app → Uninstall) to make sure you're testing the latest version.

Google Play Internal Testing
Once your Google Developer account is set up, future builds move to Google Play Internal Testing instead:

1. Locatify will send you a link to open the Android app build as an internal tester.
2. Make sure your device is connected to the correct Google account (the one associated with the email address provided on the internal testing list).
3. Share the link with the other internal testers.

iOS — TestFlight
iOS builds are only distributed through TestFlight. TestFlight is Apple's testing app.

1. You'll receive an email invitation to test via TestFlight.
2. Download the TestFlight app from the App Store, if you don't already have it.
3. Open the invitation link on your iOS device and install the app through TestFlight.
4. The testers from the internal tester list will also receive the link.

Future builds appear as updates within TestFlight — you'll be notified when a new version is ready.

3. What to Test

• App design — launch screen, main menu, navigation bar, colors, overall branding
• Menu items — verify each opens and functions correctly (map, tours and games...)
• Tours and games — tour points, game points, audio/images/videos/text, interactive elements, challenges and game mechanics (if applicable)
• Info Points — verify the info points are showing on the main map and in the dedicated menu item, if selected as showing in the list (if applicable)
• Light and Dark Mode (changeable in device settings) — repeat testing in both to catch display issues

4. How to Report Issues or Bugs

You'll receive access to a Trello board via email. When you find an issue:

1. Create a card in the "Bugfixes to do" list.
2. Specify whether it occurs on iOS, Android, or Both.
3. Add screenshots or screen recordings.
4. Describe the issue in detail: what happened, what you expected, and steps to reproduce it.
5. Include the project URL if relevant.

The more detail you provide, the faster our developers can investigate and resolve the issue.

5. How to Verify Fixes

When a developer starts working on an issue, the card moves from "Bugfixes to do" to "In Progress." Once the fix is completed, the card moves to "To Be Verified" and you'll be notified.

At this stage:

1. Install the latest build, if required.
2. Test the reported issue again.
3. Confirm whether it's resolved.

If fixed: Move the card to "Done."
If not fixed: Add a comment explaining the issue and move the card back to "Bugfixes to do."