Skip to content

Element Management

Available Now

This feature is fully implemented in the current version.

The Elements tab is your library of documented water infrastructure. Browse, search, and manage all captured elements.

Overview

Elements list view
Search active
Element detail

Elements List

The main list shows all documented elements with:

  • Thumbnail - Photo preview
  • Name/Type - Element name or type if unnamed
  • Type icon - Visual indicator of element type
  • System - Which system it belongs to (if any)
  • Sync status - Local or synced indicator

Elements are sorted by creation date, newest first.

Use the search bar to find elements by:

  • Name - Search element names (case-insensitive)
  • Type - Search by type name

The search is instant and filters as you type.

Type Filter

Filter elements by type using the filter menu:

  1. Tap the filter icon in the navigation bar
  2. Select a type (Well, Tank, Trough, Pump, Valve, Junction)
  3. List updates to show only that type
  4. Select "All Types" to clear the filter

Filters combine with search - you can search within a filtered list.

Element Detail

Tap any element to view full details:

Info Cards

CardContent
PhotoFull-size captured image
TypeEquipment type with icon
StatusActive, Inactive, or Needs Repair
LocationGPS coordinates with map link
NotesUser-added notes
CreatedCapture timestamp
SystemAssigned system (tappable to change)

Actions

Access actions via the menu button:

  • Edit - Modify element details
  • Share - Share element information
  • Delete - Remove element (with confirmation)

System Assignment

From the element detail view:

  1. Tap the System card
  2. A picker sheet appears with available systems
  3. Select a system or "None" to unassign
  4. Change is saved immediately

Inspections

The Inspections section shows the history of recorded inspections for this element. Each inspection includes:

  • Timestamp
  • Condition assessment
  • Gauge readings (if applicable)
  • Inspection photo

Note: Full inspection workflow is planned for a future release.

Deleting Elements

To delete an element:

  1. Open element detail
  2. Tap the menu button
  3. Select Delete
  4. Confirm in the dialog

Warning: Deletion also removes the associated photo. This action cannot be undone.

Empty State

When no elements exist, the list shows guidance:

"No elements yet. Use the Camera tab to add your first piece of equipment."

Data Persistence

Elements are stored locally using SwiftData:

  • Immediate save - No manual save needed
  • Offline access - View elements without internet
  • Background sync - Changes sync when connected

Next Steps

Once you have elements:

  • Group them into Systems for better organization
  • View their locations on the Map
  • Configure sync and account settings in Settings

Point. Snap. Confirm.