Docs

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

Any set row can be re-typed from its context menu. The available types are Working, Warm-up, Partial, Drop Set, Rest-Pause, Cluster, Myo-Rep, AMRAP, Back-off, Failure, Tempo, Isometric, and Eccentric.

The type is not just a label — it feeds totals, personal record checks, and Smart Suggestions. Whether warm-ups count toward totals and record checks is controlled by a setting.

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 automatically after a completed set. It can be paused and resumed, adjusted up or down, set to an exact duration, or dismissed if you want to move straight on.

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.

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.

Insights

Insights is a findings feed rather than a stats wall. It surfaces a small number of specific, personally-derived observations about your training — each one backed by a chart, and often by a one-tap action.

What It Looks For

Repster currently checks for ten patterns: muscle balance, rep-target adherence, training consistency, rest-period sweet spot, RIR calibration, personal record pace, strength trend, volume ramp, deload readiness, and exercises you have quietly dropped.

Why the Feed Is Often Short

Every finding has to clear a statistical gate before it is allowed to appear, so one well-supported insight is preferred over a dozen noisy ones. An empty feed is a valid result, not a failure — it usually means there is not yet enough data, or nothing stands out.

Reacting to a Finding

Open a card to see the detail and its chart. You can mark a finding useful or not useful, or snooze one you do not want to see for a while. Insights are computed on your device from your own logged workouts.

Where It Appears

An Insights section on Home shows the top finding with a badge for unread items, and opens the full feed.

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.

Apple Health

Repster can add your finished workouts to Apple Health. The integration is off until you turn it on, and iOS asks for permission separately before anything is written.

What Gets Written

One strength training workout each time you finish a session, containing the start time, the end time, and — only if you enable Estimated Calories — an estimated active energy value. Exercise names, weights, reps, notes and bodyweight values are never written.

Estimated Calories

A separate toggle, also off by default. The estimate is calculated on your device from the session length and your most recently logged bodyweight, using a fixed activity factor for strength training. It is an estimate rather than a measurement, and nothing is written if you have never logged a bodyweight.

Reading Health Data

Repster does not read your health data and requests no read permissions. The single exception is deletion: when you delete a workout in Repster, the app looks up the matching entry it previously wrote so it can remove that from Health too. That lookup can only find entries Repster itself created.

Turning It Off

Switching the integration off in Settings stops future writes. Workouts already written stay in Health until you delete them there, or delete the corresponding workout in Repster.

Onboarding

Initial setup helps configure Repster before the first workout.

Setup is a welcome screen followed by three short steps, and every choice can be changed later in Settings.

Welcome

A short introduction to what Repster does.

Units and Bodyweight

Choose metric or imperial, and optionally enter your current bodyweight. These share a screen because a bodyweight figure is meaningless without a unit.

Choose a Program

Pick a starting program and Repster writes its sessions into your templates as a rotation you can run straight away. Four are included: Full Body (3 days), Upper / Lower (4 days), Push / Pull / Legs (6 days), and 5×5 Strength (3 days). You can swap exercises or change program whenever you like, or choose to build your own instead.

Optional Extras

The last step offers two optional things and a way past both: bring existing workout history in from a CSV export, or take a short tour of the app. Neither is required to start training.

Apple Health is not part of setup. Repster offers the integration once, after your first completed workout, and it is always available in Settings. See Apple Health for what it does.

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 10 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.