Speck PT Documentation

Everything you need to know to coach with Speck PT.

This documentation reflects the current state of the platform. Some sections are still being expanded as new features are added.

Overview

Speck PT is a coaching platform built for personal trainers. It replaces the spreadsheets, text messages, and scattered notes you're currently using to manage clients.

The platform has two parts:

Coach Dashboard — your command centre. Build programs, view sessions, track habits, manage bookings, and keep tabs on every client from one screen. Accessed via your dashboard URL, protected by email PIN login.

Client App — what your clients see on their phone. Their program, session logging, check-ins, nutrition, goals, progress photos, and session history. Each client has their own URL with their ID embedded.

Both the dashboard and client app are web apps that work in any browser — no app store download required. Clients can add it to their home screen for an app-like experience.

Dashboard Basics

When you open the dashboard, you see the Overview — a snapshot of your coaching day.

At the top: today's date with a personalised greeting (pulled from your trainer profile), followed by stat cards showing sessions logged this week, active clients, check-in completion, and unreplied sessions.

Below that: Today's Sessions from your bookings calendar, a Needs Attention list (clients who haven't trained recently or have missing check-ins), any Flagged clients, and Recent Session Notes.

The sidebar on the left has icons for each section. Hover to expand and see labels. The sections are:

On mobile, tap the ☰ hamburger menu in the top-left to access the same navigation.

Managing Clients

There are two ways to add a client:

The Add Client panel collects: first name, last name, date of birth, email, phone, location, Instagram, emergency contact, and auto-generates a unique client ID. When you save, the client is added to the roster and their app URL is ready to share.

Share the client app URL with them: https://speckpt-app.pages.dev?client=theirid. They can bookmark it or add it to their home screen.

Removing a client doesn't delete their session history or program data — it only prevents them from syncing new data.

Client Detail Page

Click any client name to open their full detail page. The page is organised into collapsible sections. Each section header has a ☰ menu you can use to show or hide individual cards within it.

Overview section

This week's training stats, habit completion rate, weight tracking, a progress summary tile, and exercise progression chart.

Performance section

Personal records across their top lifts, estimated 1RM trend, and session history.

Program section

Their current training program with day-by-day exercise breakdown. Action buttons: Edit/Add Program, Create from Session History, One-off Session, Book Session.

Client Info section

All client-facing data in one place. Each card is toggleable from the ☰ menu:

Flagging Clients

The ⚑ Flag button attaches a note to a client that appears on your Overview page. Use it for anything you need to remember: "Check form on deadlifts", "Update program next week", "Follow up on nutrition".

Flagged clients appear in the Flagged section on Overview with a ✓ to resolve. You can also quick-flag from the Clients grid without opening the detail page.

Wellness View

The Wellness section (sidebar) gives you a collective snapshot across all clients in one screen — useful for morning check-ins before client calls or sessions.

At the top: summary tiles showing total active clients, how many checked in today, how many logged nutrition, and how many may need attention.

Below: a card for each client showing their habit compliance dot-strip (last 7 days), a compliance percentage pill, their last three logged habits, and their most recent nutrition entry. Click a client's name to jump directly to their detail page.

Building Programs

From a client's detail page, tap Edit/Add Program. The program builder lets you create multi-day training programs.

1

Add training days — click "+ Add Day" at the bottom. Name each day (e.g., "Upper", "Lower A", "Pull").

2

Add exercises — type in the search field inside each day card. The library auto-suggests as you type. Click to add. Set the number of sets and reps.

3

Group exercises — use the 🔗 button between exercises to create supersets. Use ✂ to separate. See Supersets & Grouping.

4

Update the program — click Update Current Program to push to the client. Or click Save as New Template to store it for reuse.

Create from Session History — if a client has been training without a structured program, use this to pull their session history and build a program from what they've already been doing.

Supersets & Grouping

Exercises in a program can be standalone or grouped into supersets (pairs, tri-sets, or giant sets of any size).

Each exercise has a group letter (A, B, C…). Exercises sharing a letter are performed together. In the client app they display as A1/A2 (superset), B (standalone), C1/C2/C3 (tri-set), etc.

In the program builder: click 🔗 between two exercises to merge them into the same group. Click ✂ on a grouped exercise to separate it. Groups auto-assign sequential letters as you link and unlink.

There's no limit on group size. A1/A2 is a superset, A1/A2/A3 is a tri-set, A1/A2/A3/A4 is a giant set.

Modifiers

Each exercise can have an optional modifier that tells the client how to perform the last set:

In the program builder, click the ⋯ button on any exercise to cycle through modifiers. The client app shows modifiers as a small badge below the exercise name — only visible when set.

Templates

Templates are reusable workout programs you can send to any client.

In the program builder, click Save as New Template to save the current program with a name and optional tags (e.g., "3-day", "strength", "women").

To use a template: go to Templates in the sidebar, find it, and click Send to push to a client. Click Edit to modify — you'll see Update Template (overwrites) and Save as New Template (creates a copy) as separate actions.

Sending to Clients

Updating a program replaces the client's current program. The client sees it immediately on their next app refresh. Each client gets their own independent copy.

Sending a new program overwrites the current one. Use Create from Session History to restore or reference an archived program if needed.

How Clients Use It

Clients open the app in their phone's browser (Safari or Chrome). The home screen shows a greeting, this week's training stats, a session nudge, and today's motivational quote.

The sidebar navigation (tap the ☰ icon) gives access to:

On iPhone: Safari → Share → Add to Home Screen. On Android: Chrome → three-dot menu → Add to Home Screen. This gives the app a full-screen app-like experience.

Logging Sessions

During a session, each exercise shows the previous workout's data so clients know what to aim for. They enter their actual sets as they go.

The ▸ Last line under each exercise is tappable — expand to see the last 5 workouts for that exercise. The ☰ menu on each exercise gives access to: GIF demo, exercise history, rest timer, effort tracking, coach cues, and set notes.

A rest timer banner appears at the top of the screen between sets. Tap the time to change the duration using a scroll wheel — the preference is remembered. The timer is timestamp-based and survives screen lock and app backgrounding.

When done, tap Save Session. The session syncs and a confirmation toast appears.

Basic & Advanced Mode

The client app has two display modes to avoid overwhelming new users:

Basic mode (default) — shows the essentials: session logging, check-ins, appointments, and history. Extra tracking features are hidden.

Advanced mode — unlocks nutrition tracking, progress photos, body measurements, goals, exercise analytics, and progression charts.

Clients toggle between modes in Preferences → Display Mode → Advanced Mode. The switch takes effect immediately without a reload.

Dark Mode

Dark mode is controlled from Preferences (tap the ☰ menu → Preferences). The preference saves to the device and persists across sessions. The session options sheet (tap ⋯ during a workout) also has a dark mode toggle for quick access mid-session.

Habits & Check-ins

From the dashboard, open a client's detail page → Configure Habits to set up their daily tracking. Each habit has a name, type (checkbox, number, or text), target value, and optional notes.

Common habits: "Track calories" (checkbox), "Daily steps" (number, target: 10,000), "Weight" (number), "Sleep hours" (number, target: 8).

Clients log habits from the Check-in section in the app. Each save merges with the day's existing data — so a client can log weight in the morning and steps in the evening without losing either. A ✓ appears next to already-saved habits.

The dashboard shows a habit breakdown on the client's detail page: completion bars per habit, averages vs targets, and a day-by-day log for the current week.

Nutrition

Setting targets (dashboard)

Open a client's detail page and expand the Nutrition Targets card. Enter daily targets for calories, protein, carbs, and fat. The smart macro calculator will automatically fill in the missing macro if you provide calories and any two of the three macros — it uses standard caloric values (protein: 4 kcal/g, carbs: 4 kcal/g, fat: 9 kcal/g). A live calorie breakdown shows as you type.

Logging nutrition (client app)

Clients access Nutrition from the sidebar. At the top they see a banner with any coach-set targets. Below that: a 7-day strip showing daily totals, and a log form to record calories, protein, carbs, fat, water intake, and optional notes.

Each day's entry can be edited or deleted. The 7-day strip highlights days where intake is close to or meets the target.

Nutrition is an Advanced Mode feature. Clients need Advanced Mode enabled in Preferences to see it.

Goals

Setting goals (dashboard)

Open a client's detail page and expand the Goals card. Select a goal type:

Each goal shows a progress bar as the client moves toward the target. Tap the ↻ refresh icon on strength goals to re-pull the latest estimated 1RM.

Viewing goals (client app)

Goals appear in the Progress section as a card above the exercise progression chart. Each goal shows the name, a progress bar, current vs target value, and unit.

Goals are an Advanced Mode feature.

Body Measurements

Clients can log body measurements from the Progress section (Advanced Mode). Fields include weight, body fat %, and common circumference measurements (chest, waist, hips, arms, thighs). Each entry is date-stamped.

The dashboard displays measurement history on the client's detail page under the Measurements card, including a trend chart for weight and body fat over time.

Progress Photos

Clients can log progress photos by URL from the Progress section (Advanced Mode). Each photo entry includes a date, optional label (e.g., "Front", "Side"), and notes. Photos display in a timeline grid.

On the dashboard, the client's Progress Photos card shows all logged photos in chronological order. The card is toggleable from the Client Info ☰ menu.

Exercise Library

The library contains 275+ exercises with names, categories (push/pull/legs/arms/core/cardio), equipment types (barbell/dumbbell/cable/machine/bodyweight), muscle groups, and coach cues.

Each exercise has a GIF demo. In the client app, clients can view the demo from the exercise's ☰ menu during a session.

Set types include: kg × reps, kg/side × reps, kg × reps/side, bodyweight × reps, bodyweight/side × reps, and plate-loaded. Counter-weight machine exercises (e.g., Assisted Chin-ups) use negative kg values — a decreasing number means increasing load.

You can add custom exercises via + Add Exercise and customise set types and cues per exercise.

Exercise Progression

Each client's detail page shows an Exercise Progression chart — select any exercise from the dropdown to see the estimated 1RM trend over time. Personal records are listed below with dates and NEW badges for recent PRs.

In the client app, the progression chart is accessible from the Progress section. The exercise's ☰ menu also includes a quick-access progression graph for the current exercise during a session.

Booking Sessions

From the Calendar view or a client's detail page, you can book sessions. Each booking needs a client, date, start time, duration (30/45/60 min), and optional notes.

The system detects time conflicts and syncs bookings to Google Calendar. Clients see upcoming sessions in the Appointments section of their app, with the option to cancel.

Recurring bookings — set a booking to repeat weekly for up to 52 weeks. Each instance is independent: edit or cancel one without affecting the series, or update all future sessions at once.

Calendar Integration

Bookings automatically sync to your default Google Calendar as events titled "[Client Name] <> Speck [Type]".

The dashboard Calendar view shows all bookings in a weekly grid. Click any booking to view, edit, or cancel. Click an empty slot to create a new booking. All calendar actions happen in a side panel without leaving the page.

Messaging

Go to Messages in the sidebar to send messages to clients. You can message individual clients or broadcast to multiple at once.

Clients see unread messages when they open the app and mark them read on view. You can also reply to individual sessions from the Activity Feed or a client's detail page — replies appear alongside session data.

Message Groups

Create named groups for batch messaging. Go to Messages → + Manage Groups. Groups like "Fat Loss Challenge", "Morning Crew", or "New Clients" let you auto-select recipients when composing a broadcast.

Settings & Profile

Trainer Profile — business name, display name, photo, bio, email, and phone. The display name appears in the dashboard greeting. The photo and bio appear in the client app under "My Coach".

Session Rates — pricing per session duration (30/45/60 min) for revenue tracking.

Manage Clients — add or remove clients from your roster (also accessible from the Clients sidebar panel).

Advanced Toggle — shows or hides power-user features behind a toggle. Off by default for a cleaner interface.

Google Calendar Toggle — enables or disables Google Calendar sync.