Troubleshooting - sfisher1975/Swim_With_Me GitHub Wiki

Troubleshooting

Find your issue below. If it continues, send the app administrator the exact error, a screenshot, and the app version.

The app opens the previous login screen

The app remembers the last login option used on that browser.

Use the back control on the login screen to return to the three choices.

If already signed in, sign out before switching accounts.

I confirmed my email but cannot see swimmers

Family access requires parent approval and assigned swimmer permissions.

Ask the parent to check Access requests in People & access.

After approval, choose Check approval, or sign out and sign back in.

The parent cannot see my access request

Check that you:

  1. Confirmed your email.
  2. Used the correct family code.
  3. Completed the access request.

If Join your family appears after signing in, enter your name and family code, then choose Request access.

My confirmation email never arrived

Check your spam folder and verify the email address you entered.

If the app reports email rate limit exceeded or error sending confirmation email, send that error to the administrator.

Repeated signup attempts will not fix an email delivery configuration problem.

I forgot my password

  1. Open the Parent or Family & friends sign-in screen.
  2. Enter your email.
  3. Choose Forgot password.
  4. Follow the link in the email.
  5. Set a new password.
  6. Sign in again.

The swimmer pairing code does not work

Pairing codes are single-use and expire after 10 minutes.

Ask the parent for a new code.

Use the swimmer's device, signed out of the parent account.

If the app says to enable kid-device sign-in, the administrator must check the correct Supabase project's anonymous sign-in setting and pairing setup.

A meet does not appear

The parent should check that the meet was saved for the correct swimmer.

On the swimmer or family page, use My meet to select it.

An event without a recorded result remains pending and does not have a result animation yet.

A graph looks wrong

Check the selected event and course.

Then check the saved date and time in Results.

Use these time formats:

  • Seconds: 39.35
  • Minutes and seconds: 1:28.54

Swipe sideways within a long chart or choose Full screen.

Goal lines only appear for the matching event and course.

If the saved data is correct but the display looks wrong, send a screenshot showing the event, course, and app version.

Meet deletion says a database update is needed

The administrator needs to run the included meets_migration.sql in the app's Supabase project.

Do not run the fresh-install schema over an existing database to solve this.

Messages will not send

Check your connection and select a finished race.

  • Family members send cheers through the Family portal.
  • Swimmers reply through their linked swimmer account.
  • The parent's Kid view is a preview.

If the app reports a missing database update, contact the administrator.

A removed family member still appears

Refresh the page and check for a removal error.

A successful removal reloads People & access.

If removal continues to fail, the administrator should check that the current family-member-removal database migration is installed.

I still see an old app version

Check the version in the page header.

Reload after the website update has published. If it remains old, try opening the app in a new browser tab.

Tell the administrator which version you see.

What to include when asking for help

  • Your role: Parent, Family & friends, or Swimmer
  • App version
  • What you selected or tried
  • Exact error message
  • Screenshot of the problem

Do not share passwords or pairing codes in a public Wiki or support post.

Back to Home