FitTrack - iOS Fitness Tracking App

A comprehensive fitness tracking app built with SwiftUI that helps you monitor body weight, gym workouts, and nutrition intake.

📱 Features

Body Weight Tracking

• ✅ Daily weight entry with duplicate prevention
• ✅ Interactive line chart showing weight trends
• ✅ Optional weekly average visualization
• ✅ Historical data view

Gym Workout Tracking

• ✅ Support for Push, Pull, Legs, Cardio workouts
• ✅ Log exercises with sets, reps, and weight
• ✅ Track personal records
• ✅ Visual progress charts per exercise

Diet & Nutrition Tracking

• ✅ Search foods using USDA FoodData Central API
• ✅ Automatic macro calculation (calories, protein, carbs, fat)
• ✅ Manual quantity adjustment
• ✅ Daily nutrition summary

🛠 Tech Stack

• SwiftUI: Modern declarative UI framework
• Core Data: Local data persistence
• Apple Charts: Native charting framework
• MVVM Architecture: Clean separation of concerns
• Dark Mode: Full support

📂 Project Structure

FitTrackApp/
├── FitTrackApp.swift              # App entry point
├── ContentView.swift              # Main tab navigation
├── Models/
│   ├── CoreData/
│   │   ├── FitTrackModel.xcdatamodeld  # Core Data schema
│   │   └── PersistenceController.swift  # Core Data stack
│   └── DTOs/
│       ├── FoodSearchResult.swift      # USDA API models
│       └── NutritionInfo.swift         # Nutrition structures
├── ViewModels/
│   ├── WeightViewModel.swift           # Weight logic
│   ├── WorkoutViewModel.swift          # Workout logic
│   └── DietViewModel.swift             # Diet logic
├── Views/
│   ├── Weight/
│   │   ├── WeightTrackingView.swift
│   │   └── WeightChartView.swift
│   ├── Workout/
│   │   ├── WorkoutListView.swift
│   │   ├── AddWorkoutView.swift
│   │   └── ExerciseProgressView.swift
│   └── Diet/
│       ├── DietTrackingView.swift
│       ├── FoodSearchView.swift
│       └── AddFoodView.swift
├── Services/
│   └── USDAFoodService.swift           # API integration
└── Utilities/
    ├── DateExtensions.swift            # Date helpers
    └── Constants.swift                 # App constants

🚀 Setup Instructions

Prerequisites

• macOS 13.0 or later
• Xcode 15.0 or later
• iOS 17.0+ deployment target

Step-by-Step Setup

1. Open Xcode

   • Launch Xcode from your Applications folder

2. Create New Project

   • Click "Create a new Xcode project"
   • Select "iOS" → "App"
   • Click "Next"

3. Configure Project

   • Product Name: FitTrackApp
   • Team: Select your Apple ID (or leave as "None" for simulator only)
   • Organization Identifier: com.yourname.fittrack
   • Interface: SwiftUI
   • Storage: Core Data (CHECK THIS BOX!)
   • Language: Swift
   • Click "Next" and choose save location

4. Add Files to Project

   • In Xcode's left sidebar (Project Navigator), right-click on "FitTrackApp" folder
   • Select "New Group" and create these folders:
     • Models
     • ViewModels
     • Views
     • Services
     • Utilities
   • For each .swift file in this repository:
     • Right-click the appropriate folder
     • Select "New File" → "Swift File"
     • Name it exactly as shown
     • Copy and paste the code from this repository

5. Configure Core Data

   • Delete the default .xcdatamodeld file if it exists
   • Add the FitTrackModel.xcdatamodeld file from this repo

6. Add Required Frameworks

   • Select your project in the navigator
   • Go to "General" tab
   • Under "Frameworks, Libraries, and Embedded Content", ensure:
     • CoreData.framework is present
     • Charts framework (iOS 16+)

7. Configure Info.plist for API Access

   • Select Info.plist
   • Add key: NSAppTransportSecurity
   • Add child: NSAllowsArbitraryLoads = YES
   • (Note: For production, configure specific domain exceptions)

8. Get USDA API Key (Free)

   • Visit: https://fdc.nal.usda.gov/api-key-signup.html
   • Sign up for a free API key
   • Open Services/USDAFoodService.swift
   • Replace "YOUR_API_KEY_HERE" with your actual key

9. Build and Run

   • Select a simulator (e.g., iPhone 15 Pro)
   • Press ⌘R or click the Play button
   • Wait for build to complete
   • App will launch in simulator

Troubleshooting

Build Errors:

• Ensure all files are added to the target (check File Inspector)
• Clean build folder: Product → Clean Build Folder (⇧⌘K)
• Restart Xcode if needed

Core Data Errors:

• Verify .xcdatamodeld file is included in target
• Check PersistenceController is properly initialized

API Not Working:

• Verify API key is correctly entered
• Check internet connection in simulator
• Review console logs for error messages

🎯 How to Use the App

Weight Tracking

1. Tap "Weight" tab
2. Enter your weight in pounds or kg
3. Tap "Add Weight"
4. View your progress on the chart
5. Toggle "Show Weekly Average" for smoothed trend

Workout Tracking

1. Tap "Workouts" tab
2. Tap "+" to add new workout
3. Select workout type (Push/Pull/Legs/Cardio)
4. Add exercises with sets, reps, weight
5. Save workout
6. View history and progress charts

Diet Tracking

1. Tap "Diet" tab
2. Tap "Add Food"
3. Search for food using USDA database
4. Adjust serving size
5. Add to daily log
6. View daily macro summary

🏗 Architecture Explained

MVVM Pattern

• Models: Data structures (Core Data entities)
• Views: UI components (SwiftUI)
• ViewModels: Business logic and data management

Core Data

• Local database on device
• Persistent storage across app launches
• Efficient querying and relationships

Why This Structure?

• Modularity: Each feature is self-contained
• Testability: ViewModels can be tested independently
• Maintainability: Easy to find and update code
• Scalability: Simple to add new features

🔮 Future Improvements

High Priority

• iCloud sync across devices
• Export data to CSV/PDF
• Workout templates and routines
• Nutrition goals and targets
• Progress photos with timeline

Medium Priority

• Apple Health integration
• Widgets for home screen
• Apple Watch companion app
• Meal planning and recipes
• Barcode scanner for food

Low Priority

• Social features and sharing
• AI-powered workout suggestions
• Integration with fitness trackers
• Custom exercise library
• Advanced analytics and insights

📝 Code Style Guidelines

• Comments: Every function and complex logic explained
• Naming: Clear, descriptive variable and function names
• Formatting: Consistent indentation and spacing
• Error Handling: Graceful failures with user feedback

🆘 Support

For issues or questions:

1. Check console logs in Xcode (⌘⇧Y)
2. Review error messages carefully
3. Verify all setup steps completed
4. Check Apple Developer documentation

📄 License

This is a learning project. Feel free to modify and use for personal projects.

---

Built with ❤️ using SwiftUI