Frequently Asked Questions

EvoFit Trainer is a complete coaching platform for personal trainers and their clients.

Trainers get:

• Client management with bulk operations
• A 1,324-exercise library with form GIFs
• A 7-day rotation program builder
• Reusable workout templates
• Habit and macro tracking for each client
• Periodic check-ins
• Body measurement analytics with ACWR risk monitoring
• PDF reports
• Appointment scheduling with iCal export
• WhatsApp click-to-chat for messaging

Clients get:

• Today's workout in one tap
• Set-by-set logging with RPE and RIR
• Substitution and adjustment presets mid-session
• Food journal with macro tracking
• Body measurement and goal tracking
• A direct line to their trainer via WhatsApp

Built on Next.js + Postgres + Vercel. Deployed at https://trainer.evofit.io.

Your trainer can see:

• Your name, email, profile fields you filled in
• Your bio, goals, limitations
• Workout sessions and set logs
• Body measurements
• Macro logs and food journal entries (read-only)
• Habit logs (read-only)
• Check-in responses
• Progress photo URLs
• Appointments

Your trainer can NOT see:

• Your password
• Your login history
• Your billing data (you don't pay through EvoFit — your trainer does)
• Anything from other trainers if you have past relationships

Other clients can see: nothing. Clients cannot see each other's data.

Admins can see: everything, but only for support requests. All admin actions are audit-logged.

EvoFit staff can see: the same as admins, with the same audit trail.

If you have a privacy concern, email support@evofit.io. GDPR / CCPA requests are processed within 30 days.

There's no in-app delete button yet. To delete your account:

1. Email support@evofit.io from the address on your EvoFit account.
2. Subject line: "Delete my account".
3. Include your account email and (if a trainer) your subscription tier.
4. We process within 30 days per GDPR / CCPA requirements.

What gets deleted:

• Your user record
• Your profile, health data, PAR-Q
• Your workout sessions, set logs, measurements, food journal
• Your photos, check-in responses, habit logs
• Your trainer-client relationships

What may be retained for legal reasons:

• Stripe transaction records (financial compliance)
• Anonymized aggregate analytics (counts only, no PII)
• Auditable security logs (for fraud/abuse forensics)

Your trainer's view: if you're a client and delete your account, you disappear from their roster. The historical aggregate (e.g. "12 workouts completed") survives at the trainer's level but with no identifying info.

To upgrade: Visit /pricing and click the tier you want. Stripe Checkout opens. Pay with any card. Your account is upgraded immediately on checkout.session.completed. The success page force-refreshes your JWT so you don't need to log out.

To downgrade or cancel: No in-app button yet. Email support@evofit.io and we'll process within 5 business days. No proration on one-time-purchase tiers (Starter / Professional / Enterprise) — those are perpetual.

Tier prices (one-time unless noted):

• Free — $0, 30-day trial, 1 client cap
• Starter — $199, 5 client cap
• Professional — $299, 25 client cap
• Enterprise — $399, unlimited clients
• SaaS Add-on — $39.99/month subscription for ongoing platform development

Stripe LIVE mode: activation pending — currently in test mode. Use card 4242 4242 4242 4242 with any future date and any CVC for testing.

New trainers get 30 days free from registration date. The countdown starts the moment you create your account.

During trial:

• Full access to one client (Free tier limit).
• All trainer features unlocked.
• Banner appears in the last 7 days, color-coded by urgency:
• 7-3 days: yellow
• 3-1 days: orange
• 0 days: red full-page paywall

After expiry:

• Read-only access continues — your data is safe.
• Mutating endpoints (creating programs, assigning, etc.) return HTTP 402 TRIAL_EXPIRED.
• Page-level <TrialGate> blocks dashboard pages with an upgrade modal.
• WhatsApp button still works for clients (so messaging keeps flowing).

To unblock:

1. Visit /pricing.
2. Pay any tier.
3. Stripe webhook flips your subscription to active.
4. Your JWT refreshes automatically on the success page.
5. Dashboard unlocks within 15 minutes (or sooner if you hard-refresh).

Reminders: The system sends 7-day, 3-day, 1-day, and day-of expiry email reminders via Mailgun. Daily cron at 14:00 UTC.

Why 30 days: long enough to onboard a real client and run a real program; short enough to force a real decision before you accumulate data you'll regret losing.

1. Go to /auth/login (or just https://trainer.evofit.io).
2. Click Forgot password? below the login form.
3. Enter your email. Click Send reset link.
4. Check your inbox — a reset email arrives via Mailgun within seconds.
5. Click the link in the email. It opens /auth/reset-password?token=....
6. Enter a new password (8+ characters) and confirm.
7. Log in with the new password.

Reset link expires after 1 hour for security. If it expires, request a fresh one.

Email not arriving?

• Check spam.
• Confirm the email address you typed matches your account.
• Mailgun has been stable since 2026-04-23 (we migrated to a fresh domain mg.trainer.evofit.io). If you still don't receive it, contact support@evofit.io.

Already logged in but want to change password?

• /profile/edit → Security section → Change Password.

Considering passkey (no more passwords)?

• /profile/edit → Biometric Settings → Enable Biometric Login.

Yes — Continue with Google works on both /auth/login and /auth/register. Fully wired since 2026-04-23.

How:

1. Click Continue with Google on either page.
2. Pick a Google account (or sign in to one).
3. Approve the consent screen — minimum scope (email + profile).
4. You land back at EvoFit logged in.

First time? A new EvoFit account is created automatically. If you registered for the trainer role, the 30-day free trial starts.

Existing account, same email? The system links your Google sub to the existing EvoFit account.

Apple Sign In — not yet available. Tested and pulled back; we'll re-enable when we set up an Apple Developer account.

Privacy: EvoFit does not see your Google password. We only get your email + name + Google sub (a stable per-account ID). We don't request Drive / Calendar / contacts access.

Trouble: if you see ?error=google_* in the URL after login, the page shows an amber banner explaining what went wrong (cancelled, state mismatch, token exchange failed, etc).

"Active" means status is active, pending, offline, or need_programming. Archived clients don't count against the cap.

Hitting the cap:

• Trying to add or invite a 6th client on Starter returns 403 CLIENT_LIMIT_EXCEEDED.
• Either upgrade tier, or archive an inactive client to free a slot.

Upgrading:

1. /pricing → pick higher tier → pay.
2. Cap increases immediately on Stripe webhook.
3. Re-try the invite.

Why these caps:

• Starter pays for itself with one paying client.
• Professional supports a typical solo coach's book.
• Enterprise has unlimited clients, like Professional.
• Free is for trial / personal use.

Yes. A client can have multiple active TrainerClient rows. Common cases:

• You switched trainers and the old one didn't archive you.
• You hired two specialists (one for strength, one for nutrition).
• You're evaluating multiple trainers before committing.

What you see:

• Each trainer you're linked to appears in your dashboard.
• The default WhatsApp button points to the most recent active relationship.
• Programs and check-ins from each trainer are separately listed.

Cross-trainer privacy:

• Trainer A cannot see Trainer B's programs, check-ins, or notes for you.
• Both trainers see your shared data (workouts, measurements, food journal).

To remove a trainer relationship:

• Ask the trainer to archive you (their /clients → trash icon).
• OR contact support to detach.

To switch trainers cleanly:

• New trainer invites you (you accept).
• Ask old trainer to archive (their data on you is preserved but the relationship is dormant).
• Floating WhatsApp button auto-switches to new trainer.

Yes. EvoFit Trainer is a Progressive Web App with offline support.

What works offline:

• Reading today's workout (if you visited online recently).
• Logging sets, marking workout complete.
• Logging meals.
• Logging measurements.

What doesn't:

• New programs / new check-ins (server push needs network).
• WhatsApp button (opens external app).
• Push notifications.
• The exercise library beyond what was cached.

Mechanism:

• Service Worker caches the shell + recent data.
• Writes go to IndexedDB locally.
• A SyncManager flushes pending writes when online comes back.

Indicators:

• OfflineBanner at top when offline.
• SyncStatus shows pending sync count.

Caveats:

• First-ever visit to a device must be online (Service Worker has nothing cached yet).
• Don't clear browser data while offline-pending — wipes IndexedDB.
• Force-quitting the app before sync is fine — next launch syncs automatically.

See the Working Out Offline article for the full client-side walkthrough.

EvoFit's food journal is text-only by design. No photo uploads, today or in the foreseeable future.

Why:

1. Cost. Photo storage at scale eats into our gross margin (we estimated ~$25-60 per trainer over 5 years vs ~$0 for text). Passing that to you would mean higher prices.
2. Habit. The act of typing in calories and macros builds awareness. Photos let you log without engaging — research shows the habit-building effect is weaker.
3. Privacy. Fewer people are willing to photograph everything they eat.

The numbers don't suffer. Macro tracking via text-entry has the same effect on body composition outcomes in published research as photo-based tracking, when both are done consistently.

Workaround if you want photo records:

• Take photos and store them in your own Google Photos / iCloud — outside EvoFit.
• Use a separate macro tracker (Cronometer, MyFitnessPal) for visual logging if you want one.
• For progress photos (body, not food), you can still paste a URL — see Uploading Progress Photos.

Trainer impact: Trainers cannot create / edit / delete your food journal entries either (CEO cost rule). Your journal, your data.

Enable:

1. Install EvoFit as a PWA (see Mobile Install article).
2. Open /profile/edit → Notification Settings.
3. Click Enable Push Notifications.
4. Browser prompts for permission. Click Allow.
5. EvoFit registers a Web Push subscription via VAPID.

What you'll get:

• Trainers: client invite accepted, client completed workout, free-trial expiry reminders.
• Clients: new workout assigned, check-in reminders, schedule changes.

Disable temporarily:

• /profile/edit → Notification Settings → toggle off.

Disable permanently:

• Device Settings → Notifications → EvoFit Trainer → toggle off.
• This blocks both EvoFit and the OS from delivering.

Not getting them?

1. Check the toggle is on in /profile/edit.
2. Check the device-level permission is granted.
3. Check Do Not Disturb / Focus mode is off.
4. Check the subscription endpoint is healthy (admin can read Upstash key evofit:push-sub:{userId}).

Tech note: Push subscriptions are stored in Upstash Redis with a 30-day TTL. Each device gets its own subscription endpoint.

When you subscribe to your EvoFit iCal feed in Google / Apple / Outlook, the calendar app polls our server on its own schedule:

To force an immediate refresh:

• Google: open the subscribed calendar settings in Google Calendar → "Refresh now" button (sometimes labeled "Update").
• Apple desktop: right-click the subscribed calendar in the sidebar → "Refresh".
• Apple iOS: pull down to refresh in the Calendar app.

Why we don't push updates:

• iCal is a one-way subscription protocol. The calendar app polls us; we don't push to it.
• Two-way sync (edit in Google → reflect in EvoFit) is on the long-term roadmap but requires Google Calendar API integration, which is out of scope for now.

If you cancelled an appointment in EvoFit and it's still showing in your subscribed calendar: Refresh the subscription manually. The cancelled appointment will disappear (we remove it from the iCal feed immediately).

Workout logs: Set logs are owned by you. Your trainer can't edit them. They can read them and use them for analytics.

Food journal: Your trainer is read-only. They cannot create, edit, or delete entries. CEO cost rule — clients own their journal. Trainer POST/PATCH/DELETE attempts on your food journal return HTTP 403.

Body measurements: Mixed. You log measurements yourself. Your trainer can ALSO log measurements on your behalf (e.g. they took your circumferences in person). Both writers are flagged in the History tab so you can tell which is which. Either of you can edit/delete measurements you created.

Habit logs: API-only today (no UI). Both client and trainer can submit logs via API.

Check-in responses: You submit them. Your trainer reads them. Neither party can edit a submitted response after the fact (immutable for audit reasons).

Profile fields (goals, limitations, trainer notes): Your trainer can edit these via ClientProfileEditor when they have Edit Profile mode toggled on. The structured PAR-Q is yours alone.

Programs assigned to you: Your trainer creates them and modifies them. You consume them. You can't edit a program assignment.

Photos: You own them. Your trainer is read-only.

Summary table:

Built-in exports:

• Measurements CSV — /analytics → Export CSV button. Downloads a CSV of all body measurements.
• Measurements Excel — Enterprise tier only.
• PDF report — /analytics → Generate Report button. Up to 7 sections.
• Favorites CSV — /dashboard/exercises/favorites → Export CSV (trainer's favorites only).

Not yet exportable in-app:

• Workout session logs (raw set logs).
• Food journal entries.
• Habit logs.
• Check-in responses.

Full data dump (GDPR / CCPA): Email support@evofit.io with subject "Data export request". We process within 30 days and deliver a JSON archive of:

• Your user record + profile
• All workout sessions + set logs
• All measurements
• All food journal entries
• All habit logs
• All check-in responses
• All photo URLs (we don't store the photos themselves — you provided URLs)
• All appointments

As of April 2026, Stripe is in test mode. This is the only remaining launch blocker.

What it means:

• Checkout works end-to-end in test mode.
• Test cards work: use 4242 4242 4242 4242 with any future expiration and any CVC.
• Real cards may go through but no real money is charged.
• Webhooks fire correctly (we test them with test events).

When it switches to LIVE:

• Stripe LIVE keys get added to Vercel env vars.
• Live products are created in Stripe LIVE mode.
• funnel.js price IDs are updated to live IDs.
• Redeploy.

About 15 minutes of work once Mark provides the live keys. No code changes — env-driven.

Why it's not done yet:

• One-time-purchase tier products need to be re-created in LIVE mode (Stripe doesn't auto-promote test products to live).
• Awaiting confirmation on a few business details before going live.

For trainers wanting to upgrade now:

• The product works. The pricing structure is final. The technical pipe is complete.
• Hit /pricing and use the test card to see the post-checkout experience.
• When LIVE flips on, your test purchases won't carry over — you'll need to re-purchase. We'll honor any ambiguity in your favor.

For prospects:

• Email support@evofit.io if you want to be notified the moment LIVE flips on.

For bugs in the app:

1. On any authenticated page, click the Report Bug floating button (bottom right).
2. Fill in:

• What you were trying to do
• What happened instead
• Optional screenshot

1. Click Submit.

The report includes (automatically):

• Your user ID + role
• Current URL
• Browser + OS info
• Recent console errors
• Most recent network requests

This goes to our internal admin dashboard at /admin/bugs — we triage daily.

For account / billing / privacy questions: Email support@evofit.io. Response within 1-2 business days.

For urgent production issues: Mention @dr.m.weyers on the BCI Slack (if you have access) or email with subject prefix [URGENT].

For trainer feedback / feature requests: Same email — support@evofit.io. We genuinely read these. Several shipped features started as trainer feedback (Multiply Weeks, Schedule tab, Workout Template DnD).

What we DON'T support:

• Coaching advice (your trainer's job).
• Hardware-specific issues (your phone manufacturer's job).
• Tax / legal questions about running your training business.

EvoFit uses JWT-based auth with two tokens:

• Access token — short-lived, 15 minutes. Sent on every API request.
• Refresh token — long-lived, 7 days. Used to issue new access tokens silently.

What you experience:

• Log in once and stay logged in for 7 days without re-entering credentials.
• The app refreshes your access token in the background every 15 minutes — you don't see it happen.
• After 7 days of no activity, you're logged out and need to log in again.

Active session = active 7 days. As long as you use the app at least once a week, your session keeps extending.

Logged out unexpectedly? Possible causes:

• Refresh token expired (7+ days idle).
• Password was changed (invalidates all existing sessions).
• Admin force-logout (rare, security-related).
• Token was blacklisted (Redis-backed mechanism for instant logout).

Want shorter sessions for security? Log out manually after each session via the avatar menu → Logout.

Want longer sessions? Use the Remember me checkbox on /auth/login. Same 7-day refresh token but auto-renews if you reopen the app.

Bonus — passkey login: With biometric login enabled, you can re-authenticate in 1 second after the 7-day window expires. See Mobile Install for setup.

If you open /dashboard/client and don't see today's workout, one of these is the cause:

1. No active program assigned. Check /programs — if empty, your trainer hasn't assigned one yet. Message them.

2. Today is a rest day. The 7-day cycle has empty slots. The dashboard shows "Rest day — recover and come back tomorrow." That's by design.

3. Program startDate is in the future. Your trainer scheduled the program to start later. Check /programs → click into the program to see start date.

4. /workouts/today route is broken. A known bug — /workouts/today redirects but the target doesn't exist. Use /dashboard/client or /workout-tracker instead.

5. Your trainer's tier expired. If their account hit free-trial expiry, the program they assigned still works but new mutations are blocked. You shouldn't see this often — message them.

Fix:

1. Visit /dashboard/client. Check the Today's Workout card.
2. If "Rest day" — relax. That's correct.
3. If empty / blank — message your trainer.
4. If the page errors out — file a bug via the in-app Report Bug button.

Old "I can't see workouts" bug (2-week silent 404): Resolved 2026-04-27 by adding the missing app/api/clients/[clientId]/route.ts. If you're running an old cached build, hard-refresh (Cmd-Shift-R / Ctrl-Shift-R).

Yes, fully supported.

The app is responsive — layouts adapt to phone, tablet, and desktop sizes. On a 10"+ tablet you get:

• Sidebar always visible (no hamburger).
• Workout execution screen has more room for inputs.
• Calendar grids show full month with details.
• Drag-drop in the program / workout builder is comfortable.

Install on iPad: Same process as iPhone (Safari, Share, Add to Home Screen). PWA opens in standalone mode.

Install on Android tablet: Chrome → menu → Install app.

Tested with:

• iPad Pro 11" / 12.9"
• iPad Air 10.9"
• Various Android tablets (Samsung Tab S series, Pixel Tablet)

Best use case for tablet:

• Trainer running a session in person — pull up the client's programs on the side, log measurements live.
• Client doing a workout in the gym — bigger screen for GIFs.

Stylus / Apple Pencil: Works for writing notes in the trainer's ClientProfileEditor (text fields). No drawing/sketching feature.

No native iPadOS app planned — the PWA covers the use case at lower cost.

EvoFit Trainer is a Progressive Web App (PWA). You install it directly from your phone's browser — no App Store or Play Store needed. Once installed it behaves like a native app: home-screen icon, full-screen view, push notifications, and offline workout logging.

On iPhone or iPad (Safari):

1. Open https://trainer.evofit.io in Safari (it must be Safari, not Chrome).
2. Tap the Share button (square with up arrow) at the bottom.
3. Scroll down and tap Add to Home Screen.
4. Tap Add in the top-right.

On Android (Chrome):

1. Open https://trainer.evofit.io in Chrome.
2. Tap the three-dot menu in the top-right.
3. Tap Install app (or Add to Home Screen).
4. Confirm.

The icon appears on your home screen. Tap it like any other app.

For a full walk-through with screenshots: see the trainer guide at /help/trainer/mobile-pwa or the client guide at /help/client/mobile-install.

Cloud Pro is a $10/month recurring subscription you can add to any EvoFit tier. Enterprise trainers already have it included at no extra charge.

What Cloud Pro unlocks

Who can subscribe

Any trainer on Free, Starter, or Professional can add Cloud Pro. Enterprise trainers already have it bundled — there's nothing to purchase.

How to subscribe

1. Go to /pricing.
2. Find the Cloud Pro add-on card.
3. Click Add Cloud Pro — $10/month.
4. Stripe Checkout opens. Your account is upgraded immediately on payment confirmation.

Cloud Pro is a recurring monthly subscription, separate from your one-time tier purchase. You can cancel it at any time by contacting support@evofit.io.

Admin grants

EvoFit admins can grant Cloud Pro for free (for example, to QA accounts or valued users). Granted access is identical to paid access and does not go through Stripe.

How photo upload works with Cloud Pro

When Cloud Pro is active, the progress photo upload input changes from a URL paste field to a file picker. Photos are uploaded to secure cloud storage. EXIF orientation metadata is read automatically, so sideways shots rotate correctly without manual intervention.

How push notifications work with Cloud Pro

When you publish a clients only post, EvoFit queues a Web Push notification to all your active clients. Clients need to have installed the EvoFit PWA and accepted notification permissions for delivery.

Related

• Tier and Plan Comparison
• Upgrading Your Plan
• Side-by-Side Progress Photo Compare

EvoFit offers four trainer tiers (one-time payment) and one recurring add-on. This article lists what each tier unlocks.

Pricing summary

Cloud Pro is available to any tier. Enterprise includes Cloud Pro automatically.

Feature gates by tier

Why these gates?

• All tiers get the features that are legal requirements (waiver/induction), bug fixes, and daily logging tools. Gating them would be punitive.
• Starter adds per-session customization — a power-user workflow with no ongoing infrastructure cost.
• Professional adds advanced analytics features (AI macros + measurement charts) that are formula-intensive.
• Professional also unlocks the trainer public profile + post stream.
• Enterprise adds API keys, Excel export, unlimited custom exercises and photo storage, and Cloud Pro.

Cloud Pro add-on features

One-time payment model

Starter, Professional, and Enterprise are one-time purchases — you pay once and own that tier permanently. There are no monthly fees for core features.

Cloud Pro is the only recurring charge ($10/month). You can cancel it at any time.

Upgrading

Visit /pricing to upgrade your tier. See Upgrading Your Plan for the full upgrade process.

Related

• Cloud Pro Add-on
• Upgrading Your Plan
• How do I upgrade or change my tier?

Upgrading your tier unlocks more client slots and features. The process takes under a minute via Stripe Checkout.

Upgrading your tier

1. Go to /pricing.
2. Click the tier you want — Starter, Professional, or Enterprise.
3. Stripe Checkout opens. Enter your card details.
4. Pay. Your account is upgraded immediately when the checkout.session.completed webhook fires.
5. The success page force-refreshes your session so the new tier applies without logging out.

Tier purchases are one-time payments — you pay once and own that tier permanently. No monthly charge.

Adding Cloud Pro mid-tier

You can add Cloud Pro to any tier at any time:

1. Go to /pricing.
2. Find the Cloud Pro add-on card.
3. Click Add Cloud Pro — $10/month.
4. Stripe Checkout opens for the recurring subscription.
5. Your account shows Cloud Pro active immediately on confirmation.

Professional tier — 30-day Cloud Pro trial

New Professional subscribers receive a 30-day Cloud Pro trial automatically. No credit card required for the trial — it activates when you complete your Professional purchase. If you want to continue Cloud Pro after the trial, subscribe before the trial ends from /pricing.

Downgrading or cancelling

EvoFit tiers are one-time purchases with no subscription to cancel. Your tier stays active permanently.

To cancel Cloud Pro, email support@evofit.io. We'll cancel the recurring subscription within 5 business days.

Refund policy

Starter, Professional, and Enterprise are non-refundable one-time purchases. If you have concerns, contact support@evofit.io and we'll review case by case.

Stripe test mode

Stripe is currently in test mode. Use card 4242 4242 4242 4242 with any future date and any CVC to test the checkout flow. No real charges occur in test mode.

Common pitfalls

Related

• Tier and Plan Comparison
• Cloud Pro Add-on
• How do I upgrade or change my tier?