Widgets
Keep tabs on your shots without unlocking your phone. PepTrac widgets show your next shot, daily progress, and peptide level alerts right on your home screen or lock screen.
Available Widgets
Home Screen Widget
A 2x2 square widget for your home screen. Shows:
- Upcoming Shot - The peptide or preparation name with an icon indicating the source (syringe for single peptides, pen or vial for preparations)
- Time or Status - The scheduled time, "Due Now" when it's time, or "Late" with how long it's been overdue
- Today's Shots - Color-coded badges showing Done (green), Left (blue), and Late (orange) counts
- Peptide Level Alert - A warning triangle with LOW or HIGH when Peptide Level Tracking detects levels outside your target range
Lock Screen Widget
A rectangular widget that appears below the clock. Shows:
- Top line - Syringe icon, peptide name, and status (scheduled time, "DUE", or how late)
- Bottom line - Icon-based counts: checkmark + completed, clock + scheduled, diamond + late (if any), plus level alerts
Widget States
Scheduled - Shows the peptide name and upcoming time (e.g., "8:00 AM")
Due Now - The shot time has arrived
Late - Past the scheduled time, shows how long (e.g., "2 HRS LATE")
All Set! - No more shots scheduled for today
Open PepTrac to refresh - The widget data is stale. Open the app to sync.
Peptide Level Alerts
If you have Peptide Level Tracking enabled for a protocol, the widget shows level warnings:
- LOW - Yellow warning triangle when a peptide drops below your minimum threshold
- HIGH - Red warning triangle when a peptide exceeds your maximum threshold
These alerts appear alongside your shot counts so you can see at a glance if levels need attention.
Adding the Home Screen Widget
- Long-press on your home screen until the icons wiggle
- Tap the + button in the top corner
- Search for "PepTrac"
- Tap PepTrac, then tap Add Widget
- Drag the widget to your preferred position
- Tap Done to save
Adding the Lock Screen Widget
- Long-press on your lock screen
- Tap Customize, then select your lock screen
- Tap the widget area below the time
- Find PepTrac in the widget list and tap to add
- Tap Done twice to save your changes
Removing a Widget
Home screen: Long-press the widget and tap Remove Widget.
Lock screen: Customize your lock screen, tap the PepTrac widget, then tap the minus button to remove it.
Widget Updates
Widgets stay current almost all the time. If the data ever looks out of date, tap the widget to open PepTrac—the widget will sync when you return to your home screen. iOS controls refresh timing, so occasional brief delays can happen.
Troubleshooting
Widget says "Open PepTrac to refresh" This only happens if you haven't opened the app in a while. Open PepTrac and the widget will sync automatically.
Counts look wrong or outdated Tap the widget to open PepTrac, then return to your home screen. iOS limits how often widgets can refresh, so occasional delays are normal.
Can't find PepTrac in the widget list Make sure the app is installed and not offloaded. Offloaded apps don't appear in the widget picker.