📱 Overview
Welcome to The Iron Ledger! This comprehensive mobile application helps you track your fitness journey with multi-athlete support, including weight lifting workouts, body weight progress, and advanced analytics.
Whether you're a gym enthusiast, personal trainer, or someone looking to monitor fitness progress for multiple athletes, our app provides intuitive tools to log, visualize, and analyze your data.
✨ Features
👥 Multi-Athlete Support
- Track multiple athletes in one app
- Switch between athlete profiles
- Custom profile pictures
- Editable athlete names
- Isolated data per athlete
🏋️ Advanced Workout Tracking
- 50+ predefined exercises
- Muscle group tagging with color codes
- Exercise search and filtering
- Track sets, reps, and weight
- Progress charts by exercise
- View workout history
📊 Progress Analytics
- Personal Records (PRs) tracking
- Body weight tracking
- Body fat percentage
- Interactive charts
- Total volume calculations
- Workout statistics
💎 Premium Features
- Unlimited athlete profiles
- Advanced charts & analytics
- Cloud backup & sync
- Export data to CSV
- Premium support
🚀 Getting Started
Installation
- Clone the repository from GitHub
- Install dependencies:
npm install - Start the app:
npm start - Scan the QR code with Expo Go app on your device
- Start logging your fitness data!
Note: App Store and Google Play Store releases are planned for the future.
First Time Setup
When you first open the app, you'll see three main tabs at the bottom:
- Home: View athlete profile, PRs, and stats overview
- Workouts: Track your gym workouts with exercise library
- Weight: Monitor body weight and body fat changes
The app will automatically create your first athlete profile. You can add more athletes from the Home screen by tapping "Switch Athlete".
📖 User Guides
How to Log a Workout
- Tap on the Workouts tab
- Press the + button (floating action button)
- Enter a name for your workout (e.g., "Upper Body Day")
- For each exercise:
- Tap "Add Exercise"
- Select from 50+ predefined exercises using the dropdown
- Use search to filter exercises
- Muscle group is automatically assigned
- Enter sets, reps, and weight
- Add notes (optional)
- Tap Save
- View exercise progress on color-coded charts!
How to Track Your Weight
- Navigate to the Weight tab
- Tap the + button
- Enter your current weight
- Optionally add body fat percentage
- Add notes if desired
- Tap Save
- View your last 10 entries on the chart!
How to Manage Multiple Athletes
- Go to the Home tab
- Tap "Switch Athlete" button (top right)
- View all your athlete profiles
- To add a new athlete:
- Scroll to "Add New Athlete" section
- Enter athlete name
- Tap the + icon
- Note: Free tier limited to 1 athlete (upgrade for unlimited)
- Tap any athlete to switch to their profile
- Delete athletes with the trash icon (requires 2+ athletes)
How to Customize Athlete Profiles
- On the Home screen, tap the profile picture
- Choose to take a photo or select from library
- To edit name, tap the athlete name
- Enter new name and tap the checkmark
- View Personal Records (top 10 PRs)
- See stats: total workouts, exercises, and volume
Editing and Deleting Entries
To edit or delete any entry:
- Navigate to the appropriate tab
- Find the entry in your history
- Tap on the entry to view details
- Use the Edit or Delete buttons
❓ Frequently Asked Questions
Is my data stored securely?
Yes! All your data is stored locally on your device using secure storage. Your data never leaves your device unless you choose to export it.
Can I export my data?
Data export functionality is planned for a future update. Stay tuned!
Does the app work offline?
Yes! The app works completely offline. All data is stored locally on your device, so you can log workouts anywhere.
Can I sync data across multiple devices?
Cloud sync is not currently available but is planned for a future update.
What if I accidentally delete an entry?
Unfortunately, deleted entries cannot be recovered. We recommend being careful when deleting data. A confirmation dialog appears before deletion to prevent accidents.
How do I calculate my batting average or ERA?
The app automatically calculates batting average and ERA based on the statistics you enter. Just fill in the required fields and the calculations are done for you!
Can I track other sports or activities?
Currently, the app is optimized for weight lifting and weight tracking. We're considering adding more sports and activities in future updates based on user feedback.
Is the app free to use?
Yes! The app is free to download and use with all core features available.
📚 Additional Resources
Access more detailed documentation and resources:
📦 GitHub Repository
View source code, report issues, and contribute
📄 README
Technical documentation and setup instructions
📝 Notion Guide
Detailed user guide and tips (Coming Soon)
📋 Google Doc
Comprehensive documentation (Coming Soon)
Note: Notion and Google Doc links will be added once the documents are published. Contact us to request access to these resources.
📧 Contact & Support
Need help or have questions? We're here to assist you!
Get in Touch
For support, bug reports, or feature requests:
GitHub Issues: Report an Issue
Repository: github.com/blakewallace3/exercise
Feedback
We love hearing from our users! Your feedback helps us improve the app. Please feel free to:
- Report bugs or issues
- Suggest new features
- Share your success stories
- Contribute to the project