Data Management

Athletes and Sessions

5KClock can work with manually created athlete data, CSV imports, in-app meet and race creation, cached API meets, and saved session files.

Setup

Athlete Management

  • Add and edit athletes directly in the app.
  • Store first name, last name, gender, goal 2-mile time, and goal 5K time.
  • Create rosters or lists for races or training groups.
  • Import athletes from CSV, with an option to replace existing entries.
  • Use local app athletes in the Meters clock.

Meet and Race Setup

  • Create a meet and race inside the app for offline-first use.
  • Assign athletes to the race before starting the clock.
  • Load API meets when signed in to Copley Running.
  • Cache API races for offline availability after download.
  • Delete cached API races from the saved API meet list.

Sessions Library

Pressing Save/Finish on a race or meters clock archives the session. Sessions can include CSV output, event metadata, tap counts, split details, and recordings.

Session Action What It Does
Open Displays saved split rows and session details.
Share Shares the saved CSV and attached recordings using the iOS share sheet.
Upload Uploads the saved CSV results to Copley Running when the user is signed in.
Delete Removes the session CSV and attached recordings from the device.

Save/Finish Choices

Choice Result
Save File Writes the CSV, attaches recordings, stores the session, and resets the clock.
Do Not Save Discards the session and clears temporary race data.
Cancel Returns to the active clock.

Files and Recall

The default storage location is On My iPhone / 5KClock, though the app can use another default folder chosen in Settings.

Saved split rows remain editable after the race. Users can reopen a session and assign athletes or adjust order values later, including meters sessions that were saved without athlete assignments.

Recommended Race-Day Flow

  1. Load or create the meet before leaving reliable network coverage.
  2. Confirm athlete assignments and device roles before the race starts.
  3. Use Change Time only when devices must be aligned to the same official start time manually.
  4. Save/Finish immediately after the race so the session is archived and the active race state is cleared.
  5. Upload from Sessions when the device has network access.