Setting Up RepTrack Widgets on iOS

Widgets put your training data where you can see it without opening the app. A glance at your home screen tells you what workout is scheduled today. A look at your lock screen shows your training streak. This kind of ambient visibility turns RepTrack from something you open when it is time to train into a persistent presence that keeps fitness front of mind throughout the day.

RepTrack offers several widgets for both the home screen and lock screen, each designed to surface a specific piece of information at a glance. This guide covers every available widget, how to add them, and how to configure them for your workflow.

Available Widgets

Today's Workout

What it shows: The name of your scheduled workout for today, along with the target muscle groups and exercise count.

Why it matters: You never have to open the app to check what you are training today. The widget serves as a passive reminder and helps you mentally prepare for the session.

Sizes available: Small (compact name and muscle groups), Medium (name, muscle groups, and exercise preview)

Streak Ring

What it shows: Your current consecutive training streak displayed as a circular progress ring, with the number of days in the center.

Why it matters: Streaks are a powerful motivator. Seeing your streak number every time you check your phone creates a gentle psychological push to keep it going. Breaking a 30-day streak feels worse than missing a random Tuesday — that is the point.

Sizes available: Small (ring only), Circular (lock screen ring)

Weekly Volume

What it shows: Your total training volume for the current week, typically displayed as total sets or total weight moved, along with a comparison to the previous week.

Why it matters: Volume is the primary driver of hypertrophy. Seeing your weekly volume accumulate in real time lets you know if you are on track or falling behind your usual output.

Sizes available: Small (number only), Medium (number with weekly comparison bar)

Next Session

What it shows: The name, date, and time of your next scheduled workout.

Why it matters: If your next workout is tomorrow at 6 AM, the widget serves as a planning prompt — you know to set your alarm, prep your gym bag, and eat appropriately. It removes the friction of checking the app to see when you train next.

Sizes available: Small (name and time), Medium (name, time, and exercise preview)

Adding Home Screen Widgets

iOS home screen widgets live alongside your app icons and provide information at a glance. Here is how to add a RepTrack widget to your home screen:

1. Enter jiggle mode — long-press on any empty area of your home screen until the apps start jiggling
2. Tap the plus (+) button in the top-left corner of the screen
3. Search for RepTrack in the widget gallery — type "RepTrack" in the search bar or scroll to find it
4. Browse available widgets — swipe through the widget options to see different types and sizes
5. Select your widget — tap the widget you want to add
6. Choose the size — if the widget comes in multiple sizes, select your preferred option
7. Tap Add Widget — the widget appears on your home screen
8. Position it — drag the widget to your preferred location on the home screen
9. Exit jiggle mode — tap Done or press the home button

The widget immediately begins displaying your data. If you have an active training program and today has a scheduled workout, the Today's Workout widget populates right away.

Adding Lock Screen Widgets

Lock screen widgets are smaller and more constrained than home screen widgets, but they are visible without unlocking your phone — making them even more ambient.

1. Long-press on your lock screen to enter customization mode
2. Tap Customize and select the lock screen
3. Tap the widget area below the time display
4. Search for RepTrack in the widget picker
5. Select a widget — lock screen widgets are typically circular or rectangular inline widgets
6. Position it in one of the available lock screen widget slots
7. Tap Done to save

Lock screen widgets are ideal for the Streak Ring (a small circular display showing your streak count) and the Next Session widget (showing when you train next). These provide maximum visibility with minimal screen real estate.

Widget Sizes Explained

iOS widgets come in standard sizes, and RepTrack offers different information density at each size:

| Size | Dimensions | Best For | |---|---|---| | Small | 2x2 icon grid | Single metric — streak count, volume number, workout name | | Medium | 4x2 icon grid | Metric with context — workout name plus exercise list, volume with weekly comparison | | Circular (Lock Screen) | Inline circle | Streak ring, single number | | Rectangular (Lock Screen) | Inline rectangle | Next session name and time |

Choose the size based on how much information you want at a glance and how much home screen real estate you are willing to dedicate. Small widgets are unobtrusive. Medium widgets provide more context but take up more space.

Customization Options

After adding a widget, you can customize some options depending on the widget type:

Editing Widget Configuration

1. Long-press the widget on your home screen
2. Tap Edit Widget (if available for that widget type)
3. Adjust available options — such as which metric to display or which program to reference
4. Tap outside the configuration popup to save

What You Can Customize

• Today's Workout — if you have multiple active programs, you can select which one the widget references
• Weekly Volume — choose between total sets, total reps, or total weight as the displayed metric
• Streak Ring — displays your current consecutive training day streak (no configuration needed)
• Next Session — automatically shows the next scheduled session from your active program

Keeping Widgets Updated

Widgets update automatically, but iOS controls the refresh schedule to preserve battery life. Here is what to know:

• Widgets refresh periodically — iOS determines the refresh frequency based on how often you view the widget and overall system activity. High-usage widgets refresh more frequently.
• Widgets refresh when you open the app — launching RepTrack triggers an immediate widget refresh. If your widget looks stale, open the app briefly and it will update.
• Live Activity during workouts — when you are actively logging a workout, RepTrack can use iOS Live Activities to provide real-time updates on your lock screen and Dynamic Island, separate from the standard widget system.

If a widget appears stuck or shows outdated information:

1. Open RepTrack to trigger a refresh
2. If the widget still shows old data, remove it and re-add it
3. Ensure RepTrack has Background App Refresh enabled — go to iOS Settings, then General, then Background App Refresh, and confirm RepTrack is toggled on

Recommended Widget Layouts

Here are a few widget arrangements that work well for different training styles:

The Accountability Layout

• Home screen: Medium Today's Workout widget + Small Streak Ring widget
• Lock screen: Circular Streak Ring

This layout keeps your daily workout and streak visible at all times. Every phone check is a reminder of what you are building.

The Data-Driven Layout

• Home screen: Medium Weekly Volume widget + Small Next Session widget
• Lock screen: Rectangular Next Session

For trainees who are focused on volume progression and scheduling. The weekly volume widget shows whether you are on pace, and the next session widget keeps your schedule visible.

The Minimalist Layout

• Lock screen only: Circular Streak Ring

If you do not want widgets on your home screen, a single lock screen streak ring provides subtle accountability without visual clutter.

Common Issues

Widget shows "Open RepTrack to load data." This happens when RepTrack has not been opened since the widget was added, or when background refresh is disabled. Open the app once to populate the widget.

Widget not appearing in the widget gallery. Ensure RepTrack is updated to the latest version. Widget support requires a minimum iOS version — check that your iPhone is running iOS 16 or later for lock screen widgets, iOS 14 or later for home screen widgets.

Widget data seems delayed. iOS intentionally throttles widget refreshes to save battery. This is normal behavior. The widget will update the next time you view it or open the app. For real-time data during workouts, rely on Live Activities rather than standard widgets.

Multiple widgets showing the same data. Each widget instance is independent. If you add two Today's Workout widgets, they show the same information because they reference the same data source. Use different widget types for variety.