FitTrack - Your Personal Fitness Companion

FitTrack is a comprehensive fitness tracking application built with Flutter that helps users monitor their health and fitness journey. With a clean, intuitive interface and powerful features, FitTrack makes it easy to track workouts, meals, and overall progress.

🚀 Features

• Activity Tracking: Monitor your daily activities and workouts
• Meal Planning: Plan and track your meals with a built-in meal planner
• Progress Monitoring: Track your fitness journey with detailed statistics and charts
• User Authentication: Secure login and profile management
• Responsive Design: Works seamlessly across different screen sizes
• Localization: Supports multiple languages for global accessibility

🛠️ Dependencies

Core Dependencies

• flutter_bloc: State management
• dio: HTTP client for API calls
• get_it: Service locator for dependency injection
• shared_preferences: Local data storage
• rxdart: Reactive extensions for Dart

UI Components

• flutter_screenutil: Responsive UI design
• fl_chart: Beautiful charts and graphs
• carousel_slider: Image carousels
• dropdown_button2: Enhanced dropdown buttons
• lottie: Beautiful animations

Media & Assets

• cached_network_image: Efficient image loading
• flutter_svg: SVG image support
• image_picker: Image selection from device

State Management & Architecture

• bloc: State management solution
• dartz: Functional programming in Dart
• easy_localization: Internationalization support

🚀 Getting Started

Prerequisites

• Flutter SDK (version 3.6.1 or higher)
• Dart SDK (version 3.0.0 or higher)
• Android Studio / Xcode (for mobile development)

Installation

1. Clone the repository:

   git clone https://github.com/aliNassef/FitTrack.git
   cd FitTrack

2. Install dependencies:

   flutter pub get

3. Run the app:

   flutter run

🏗️ Project Structure

lib/
├── core/               # Core functionality and utilities
├── features/           # Feature modules
│   ├── activity/       # Activity tracking
│   ├── auth/           # Authentication
│   ├── home/           # Home screen
│   └── meal_planner/   # Meal planning
└── main.dart          # Application entry point

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

• Ali Nassef

🙏 Acknowledgments

• Thanks to all open-source packages used in this project

• Special thanks to the Flutter community

• Lab: Write your first Flutter app

• Cookbook: Useful Flutter samples