Speck PT — Tester Guide

Thanks for helping test the coach dashboard and client app. This guide covers setup, what to try, and what to watch for.

Getting access

Both the dashboard and client app are protected by Cloudflare Access. When you first visit either URL, you'll see a login screen.

1. Message Speck to let him know you're setting up (so he can provide your one-time code).
2. On the login screen, enter this email address: miikespeck@gmail.com
3. Enter the one-time code Speck sends you.
4. Once authenticated, the app should load normally on that device/browser.

If the code expires or login fails, message Speck again for a fresh code.

What you're testing

The backend is Google Apps Script + Google Sheets. After a backend deploy, new server-side features only work once that deploy is live.

Demo mode (dashboard)

When you open the dashboard, demo mode is ON by default. That means:

• You can browse every client and see their data.
• You can only edit three test clients: Speck, Test, and Test2.
• All other clients are view-only (saves and sends are blocked).
• An orange banner appears at the top when demo mode is active.

Coach dashboard — quick tour

Home / client list

• Tap a client to open their client detail view.
• Summary stats: frequency, tonnage, recent workouts.
• Client App Sections card — toggle habits, nutrition, food diary, measurements, or photos off for that client (syncs to their app).
• Copy app link — sends the client their personal URL.

Logging a workout

1. Open a test client.
2. Tap One-off Session (or launch a program day from Continue Current Program).
3. Add exercises, enter sets (weight × reps).
4. Save session.

Programs

• Edit / Add Program — build training days and exercises.
• Choose New Program — start from a template or blank.
• Send program — pushes the program to the client app (test merge warning on template send if client already has a program).

Goals (client detail → Overview)

• Goals sit in the Overview section (collapsible card).
• Use + Add goal to add goals (general or strength-linked to an exercise).
• Tap Save Goals — you should see a toast: “Goals saved”.
• Reload the client — goals should persist. Delete should confirm and show a toast.

Food diary (client detail → Client Info)

• Clients log entries in the client app (Nutrition → Today's food).
• Coach sees Food Diary card under Client Info (recent entries).

Messages

• Message button on client detail opens the thread.
• Client replies from Messages in the client app.

Activity feed

• Home view shows Clients vs Coach activity.
• Coach tab logs program sends and workout saves (from deploy date forward).

Settings

• Demo mode, trainer profile, rates, etc.
• App version shown in footer.

UI notes (recent)

• Session draft and rest timer appear as fixed top banners while active.
• Goals card is collapsible with + Add goal.

Client app — quick tour

Your link

Open your personal link, for example:

https://speckpt-app.pages.dev/?client=test

For testing, use test, test2, or speck.

Install on phone (optional): Safari → Share → Add to Home Screen.

Main flows

App sections (client or coach can hide)

In Settings → App Sections, turn off anything you don't want:

• Habits
• Nutrition (daily totals)
• Food diary (Today's food)
• Measurements
• Progress photos

Coach can set the same toggles on the dashboard Client App Sections card. Changes sync via the server.

Logging a workout

1. Program → pick a day (or Home → start workout / Record Single Workout).
2. Enter sets for each exercise. Rest timer runs from the top banner during the workout.
3. Save Workout — toast “Workout saved ✓”.
4. Confirm it appears in History and on the dashboard for that client.

Food diary

1. Nutrition → Today's food.
2. Enter time, Food/Drink type, description (required), optional calories/protein.
3. Add to diary — appears in today's list.
4. Coach should see entries under Food Diary on client detail.

Suggested test checklist

Dashboard

• Log in via Cloudflare Access (one-time code from Speck).
• Demo mode banner visible; edit Test client, confirm another client (e.g. Amy) is view-only.
• Log a workout for Test — saves successfully.
• Add a goal, Save Goals, see toast, refresh — goal still there.
• Toggle Client App Sections (e.g. hide Photos) for Test.
• Send or update a program for Test (if you have template access).

Client app

• Open ?client=test link.
• Log a workout from a program day; leave and confirm Workout in progress banner.
• Add 2–3 food diary entries; delete one.
• Turn off Progress photos in Settings — Photos tab disappears on Progress.
• Turn section back on (or coach re-enables on dashboard).
• Send a message; confirm it shows on dashboard.

Cross-device

• Repeat key flows on iPhone (one-handed, between sets).
• After an update, fully close the PWA and reopen from the home screen icon.

Updates & versions

• Dashboard checks version.json and Apps Script for updates; banner prompts refresh.
• Client app: close from the app switcher and reopen from the home screen icon after updates.
• Current versions: Dashboard 13.23.0, Client App 14.25.0, Apps Script 3.13.0.

Known limitations (not bugs for this test)

• Client URLs use ?client=name — not secret; token-based links planned later.
• Demo mode protects real client data when sharing the dashboard link.
• Coach activity feed only includes actions after the feature was deployed.
• Some exercise GIFs may be missing (tracked separately).

Reporting issues

When something breaks, please send:

1. Which app (dashboard or client) and version (footer).
2. Client name (e.g. test).
3. Device (iPhone Safari, Mac Chrome, etc.).
4. Steps to reproduce.
5. Screenshot if possible.

Speck keeps a bug log in the project — your notes go straight into the next fix pass.