Repster

Feature guide

Docs

A practical guide to the main Repster workflows: logging workouts, using templates, reviewing records, understanding progress, and managing your data.

Home Dashboard

The Home screen is the launch point for training and a quick snapshot of recent activity.

Customizable Sections

Use home screen editing to choose which sections are visible, including monthly stats, recent workouts, and recent personal records.

Week Strip

The week strip shows workout activity day by day. Days with workouts are marked so you can scan the week quickly and jump into calendar detail.

Start Workout

The start workout card gives you three ways to begin:

  • Empty workout: start fresh and add exercises as you go.
  • Copy previous: duplicate the structure of a recent completed workout.
  • From template: launch a saved routine with its exercises and set targets already loaded.

Recent Workouts

Recent workouts show completed sessions with their title, date, exercises, sets, duration, volume, and trained categories.

Monthly Stats

Monthly stats summarize the current month so you can track training consistency and workload without opening charts.

Recent PRs

Recent personal records are surfaced on Home so new bests remain visible after the workout is saved.

Active Workout

The active workout screen is where sets are logged. It is designed to keep current-session entry fast while still showing useful context for each exercise.

Exercise Tabs

A horizontal exercise strip lets you move between exercises in the current workout. Each exercise includes these views:

  • Sets: the main data entry view for logging set details.
  • History: previous sessions for the same exercise.
  • PRs: personal records for the exercise.
  • Charts: exercise-level progress graphs.

Set Entry

Set rows handle the fields required by the exercise tracking type, such as weight, reps, duration, distance, RIR, and completion status. For unilateral exercises, left and right work can be tracked separately.

Set Types

Sets can be marked as working, warmup, or partial where supported. These classifications help totals, PR checks, and suggestion calculations stay meaningful.

Smart Weight Suggestions

When enabled, Repster shows suggested weight for the next set based on recent performance, target reps, target RIR, and fatigue modeling.

Rest Timer

The rest timer starts after completed sets. It supports pause and resume, time adjustments, and compact behavior so the timer stays visible while logging.

Session Timer

The workout header tracks elapsed time from the start of the session until the workout is finished.

Adding Exercises

Add exercises at any point during a workout. The exercise picker supports search and filtering so the active session can change as training changes.

Workout Summary

When a workout ends, the summary shows total exercises, sets, volume, duration, editable title and notes, effort rating, fatigue feedback, and the option to save the workout as a template.

Smart Suggestions

Smart Suggestions is Repster's fatigue-aware weight recommendation system. It estimates a useful next-set load from your recent capacity, current session fatigue, and target effort.

How It Works

  • Base e1RM estimation: reviews recent peak performances in the configured recency window to estimate current exercise capacity.
  • Fatigue accumulation: models how fatigue builds through sets based on work performed, effort, and rest.
  • Forward projection: accounts for expected fatigue on upcoming sets, not only the current set.
  • Freshness bonus: can add a small first-set boost when you are fresh.
  • Readiness clamping: keeps the effective capacity estimate within a reasonable range.
  • Weight prescription: converts the effective e1RM into a target weight using the selected formula, target reps, target RIR, and exercise increment.

Configuration

Prescription settings let you tune recency window, target reps, target RIR, fatigue modeling, first-set freshness behavior, and weight rounding increments.

Adaptive Fatigue Learning

Fatigue learning helps Smart Suggestions adapt over time by comparing predicted performance with actual completed sets.

How It Learns

After qualifying working sets, Repster can record a prediction-versus-actual observation. Those observations are normalized so different rep ranges and loads can be compared.

Global and Per-Exercise Tuning

  • Global baseline: adjusts the default fatigue behavior across exercises after enough qualified data exists.
  • Per-exercise tuning: refines the fatigue rate for specific exercises after repeated qualifying sessions.

Smoothing and Bounds

Repster smooths cumulative error over time so one unusual session does not overcorrect future suggestions. Fatigue rates are bounded to keep recommendations within a reasonable range.

Workout Feedback

Post-workout fatigue feedback such as less aggressive, about right, or more aggressive helps the app understand whether recommendations matched your effort.

Admin Detail

Advanced fatigue diagnostics can show baseline state, per-exercise tuning, observation logs, set audit detail, and reset controls where available.

Exercise Management

Repster includes a seeded exercise library and supports fully custom exercises.

Browsing and Searching

The exercise library supports search, filters, and modes for browsing exercises or selecting exercises to add to an active workout.

Exercise Properties

Exercises can define name, equipment, primary and secondary muscles, movement pattern, tracking type, unilateral behavior, bodyweight factor, weight increment, and default rest time.

Tracking Types

Tracking types determine which fields appear in set entry. Supported styles include weight and reps, duration, duration and distance, weight and distance, weight with reps and duration, and custom tracking. Once sets exist for an exercise, tracking type changes may be restricted to protect historical data.

Exercise Detail

Exercise detail views show history, personal records, aggregate stats, best e1RM, volume, and trend information where available.

Personal Records

Repster automatically evaluates completed sets and detects personal records for each exercise.

How Detection Works

Completed sets are compared against the full exercise history with precise weight handling so records are not affected by floating-point rounding issues.

PR Statuses

  • Current: the set is currently on the performance frontier.
  • Matched: the set ties an existing current record.
  • Previous: the set used to be a record but has since been surpassed.
  • Dominated: a higher-rep set exists at equal or greater weight, making this less meaningful as a current record.

Frontier Logic

The record system uses frontier-style comparison so a lower-rep performance is not treated as current when a stronger higher-rep performance already exists at the same or greater load.

Where PRs Appear

PRs appear on set rows, Home, exercise detail, and the PR view inside active workouts.

Templates

Templates save workout structure so repeated routines can be started quickly.

Creating Templates

  • Save from workout: turn a completed workout into a reusable template.
  • Create manually: build a template from exercises, targets, and set counts.
  • Import: bring in a shared template file.
  • AI helper: generate a prompt for ChatGPT and import the returned template JSON manually.

Using Templates

Tap a template to start a workout with its exercise structure, targets, and ordering already prepared.

Supersets

Templates can preserve grouped exercise ordering for superset-style routines where supported.

Import and Export

Template files can be exported, shared, imported, previewed, and validated before being added to your library.

Calendar

The Calendar tab gives a visual overview of training history.

Monthly Grid

The calendar shows workout activity across months. Days with workouts are marked with category dots so training distribution is visible without opening each day.

Day Detail

Tap a day to see workouts completed on that date, including trained categories, exercises, sets, volume, title, and duration.

Past Workout Detail

Past workouts can be opened from the calendar to review exercise and set detail. Completed workouts can also be reused as templates.

Charts and Analytics

Charts summarize training across time ranges and categories.

Breakdown

Breakdown charts show volume distribution by muscle group or exercise so training balance is easier to inspect.

Workouts

Workout charts show frequency, workload, set totals, and trend information over time.

Exercises

Exercise charts track selected exercises across sessions, making it easier to inspect load, reps, volume, and performance direction.

Time Filters

Charts support time filters such as week, month, year, and all time depending on the chart.

Settings

Settings control units, formulas, data management, and workout behavior.

General

  • Units: choose metric or imperial units.
  • e1RM formula: select the estimated one-rep-max formula used in calculations.

Workout

  • Rest time: set default rest timing.
  • Warmup inclusion: control whether warmups are included in totals and record checks.
  • Prescription settings: configure Smart Suggestions and fatigue behavior.

Data

  • Import data: bring in compatible CSV history.
  • Export backup: create a backup file.
  • Restore backup: restore from a previous backup.
  • Reset app data: delete local app data after confirmation.

Body Weight Tracking

Bodyweight entries can be logged from Settings and used in effective weight calculations for bodyweight-factor exercises.

Logging Entries

Add entries with date and weight values. Repster uses the nearest relevant value where bodyweight contributes to performance calculations.

Role in Calculations

For exercises such as pull-ups or dips, bodyweight factors help PRs, e1RM estimates, and suggestions reflect the total load more accurately.

Import and Export

Repster supports data import, backup export, restore, and reset workflows from Settings.

CSV Import

Compatible CSV imports are previewed and validated before saving. The import can create missing exercises, process rows in batches, and rebuild records and stats afterward.

Full Backup

Backup export creates a file containing app data such as workouts, exercises, sets, templates, settings, and learning data. You choose where to store that file.

Restore

Restore uses a previously exported backup file and handles conflicts according to the restore flow shown in the app.

Reset

Reset App Data deletes local app data after confirmation and restores the app to a fresh state.

Onboarding

Initial setup helps configure Repster before the first workout.

Quick Setup

Quick setup gets you into the app quickly with the minimum required preferences.

Advanced Setup

Advanced setup can include unit preference, e1RM formula selection, bodyweight entry, and optional import. These choices can be changed later in Settings.

Subscription

Repster includes a free tier for trying the app. Full access unlocks unlimited workout logging and is managed through Apple's App Store subscriptions.

Free Tier

The free tier lets you log up to 5 workouts before subscribing.

Full Access

After the free tier, an active subscription unlocks unlimited logging. Subscription purchase, renewal, cancellation, and refund handling are managed by Apple through your Apple ID.