Skip to content

Adarsh-m-0/Fitpy

Repository files navigation

FitPy 🏋️

Your Personal Fitness Journey Companion
An open-source fitness tracking application built with Flutter.

License: MIT Flutter GitHub Issues PRs Welcome

Table of Contents


🚀 Features

Core Functionality

  • 📊 Workout tracking with sets/reps/weight logging
  • 📈 Progress analytics with interactive charts
  • 🏅 Achievement system with badges and streaks
  • 📚 Exercise library with 150+ predefined movements

Technical Highlights

  • 🔒 Local-first data storage (Hive database)
  • � Clean Architecture implementation
  • 🌓 Dark/Light theme support
  • 📱 Responsive mobile-first design

📥 Installation

Requirements

  • Flutter 3.19.0+
  • Dart 3.0.0+
  • Android Studio or VS Code

Quick Start

git clone https://github.com/Adarsh-m-0/Fitpy.git
cd Fitpy
flutter pub get
flutter run

### Build Releases
```bash
# Android
flutter build apk --release

# iOS (requires macOS)
flutter build ios --release

🖥️ Usage

Basic Workflow:

  1. Create workout routine
  2. Add exercises from library
  3. Track daily sessions
  4. Analyze progress in charts

Keyboard Shortcuts (Web):

  • Ctrl+N: New workout
  • Ctrl+S: Save session
  • Ctrl+P: Progress view

🛠 Tech Stack

Category Technologies
Framework Flutter
State Management Riverpod
Local Database Hive
Charts FL Chart
DI Get It
Testing Mockito, Bloc Test

🏗 Architecture

lib/
├── core/
│   ├── constants/
│   ├── utils/
│   └── themes/
├── data/
│   ├── datasources/
│   ├── models/
│   └── repositories/
├── domain/
│   ├── entities/
│   ├── repositories/
│   └── usecases/
└── presentation/
    ├── widgets/
    ├── pages/
    └── providers/

Key Principles:

  • Clean Architecture
  • SOLID Principles
  • Reactive Programming
  • Immutable State

🤝 Contributing

  1. Fork the repository
  2. Create feature branch (feat/feature-name)
  3. Commit changes following Conventional Commits
  4. Open Pull Request

Development Tips:

# Run static analysis
flutter analyze

# Generate models
flutter pub run build_runner build

# Run tests
flutter test

About

FitPy is an open-source fitness tracking app built with Flutter, offering workout logging, progress tracking, guided programs, and an exercise library—all with offline support and no account required.

Topics

Resources

License

Contributing

Stars

0 stars

Watchers

1 watching

Forks

Packages

 
 
 

Contributors