Installation

Waterworks is currently distributed via TestFlight for beta testing.

Requirements

• iPhone running iOS 17.0 or later
• Camera access (for equipment capture)
• Location services (for GPS tagging)

TestFlight Installation

1. Get the TestFlight app from the App Store if you don't have it
2. Open your invitation link (provided by your administrator)
3. Tap "Accept" in TestFlight
4. Tap "Install" to download Waterworks

The app will appear on your home screen with a yellow dot indicating it's a beta version.

First Launch

When you first open Waterworks:

1. Grant camera access when prompted - this is required for the camera-first workflow
2. Grant location access when prompted - this enables GPS tagging of elements
3. Tap Start Mapping and use the Capture tab to document your first piece of equipment

Permissions

Waterworks requests the following permissions:

Permission	Why It's Needed
Camera	Primary input for documenting equipment
Photo Library	Access existing photos for documentation
Location	GPS tagging of elements for map visualization

All permissions can be managed in Settings → Waterworks.

Offline Use

The field pilot works locally—no account or network connection is needed after installation. You can use it in remote pastures without cellular or Wi-Fi coverage.

What works offline

All core features work without internet:

• Capture photos — Take or choose equipment photos
• Equipment suggestions — An experimental on-device model suggests a type for you to verify
• GPS location — Coordinates are captured from your device or photo metadata
• Create elements — Add new infrastructure to your records
• View existing data — Browse all your elements, systems, and photos
• Search and filter — Find what you need quickly

What requires connectivity

Some features need an internet connection:

• Initial app download — Download from TestFlight requires internet
• App updates — New versions download via TestFlight

Cloud sync and web access are disabled for this pilot. Records and photos stay on this iPhone. Do not delete the app during the pilot: deleting Waterworks removes its pilot data from the device.

Read the Field Pilot guide before the first mapping day.

Updating

TestFlight will notify you when new versions are available. Updates include bug fixes, new features, and improved AI models.

To update:

1. Open TestFlight
2. Find Waterworks in your apps
3. Tap "Update" if available