https://github.com/aryanvbw/fitness-app
https://github.com/aryanvbw/fitness-app
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/aryanvbw/fitness-app
- Owner: AryanVBW
- Created: 2025-04-17T18:18:31.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-20T18:53:24.000Z (about 1 year ago)
- Last Synced: 2025-09-06T19:02:45.470Z (10 months ago)
- Language: HTML
- Size: 90.8 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Fitness Tracker App
A comprehensive fitness tracking Android application built with Java, featuring workout management, profile customization, and activity tracking. Compatible with Android 7.0 (API 24) and above.
## Features
- 🏋️ Guided Workout Sessions
- Countdown timer (3-2-1)
- 15-second exercise intervals
- "+5s" time extension
- Progress tracking
- Pause/Resume functionality
- 📊 Activity Dashboard
- Daily/weekly statistics
- Progress visualization
- Achievement tracking
- 👤 User Profile Management
- Customizable user details
- Dark theme support
- Progress history
- 📚 Exercise Library
- Categorized exercises
- Detailed instructions
- Custom workout creation
- 🔔 Smart Notifications
- Workout reminders
- Progress updates
- Achievement alerts
## Architecture
```mermaid
graph TD
A[User Interface Layer] --> B[Business Logic Layer]
B --> C[Data Layer]
subgraph "UI Components"
A1[Activities] --> A2[Fragments]
A2 --> A3[Custom Views]
A3 --> A4[Adapters]
end
subgraph "Business Logic"
B1[Workout Manager] --> B2[Timer Service]
B2 --> B3[Progress Tracker]
B3 --> B4[Notification Manager]
end
subgraph "Data Management"
C1[Local Storage] --> C2[SharedPreferences]
C2 --> C3[SQLite Database]
end
```
## Component Interaction Flow
```mermaid
sequenceDiagram
participant U as User
participant WS as WorkoutSession
participant TM as TimerManager
participant PM as ProgressManager
U->>WS: Start Workout
WS->>TM: Initialize Countdown (3s)
TM-->>WS: Countdown Complete
WS->>TM: Start Exercise Timer (15s)
loop Exercise Duration
TM-->>WS: Update Progress
WS-->>U: Display Time
opt Add Time
U->>WS: Press "+5s"
WS->>TM: Extend Timer
end
end
TM-->>WS: Exercise Complete
WS->>PM: Save Progress
PM-->>U: Show Summary
```
## Data Flow Architecture
```mermaid
flowchart LR
A[User Input] --> B{Activity Router}
B --> C[Profile Manager]
B --> D[Workout Session]
B --> E[Exercise Library]
C --> F[(Local Storage)]
D --> F
E --> F
F --> G[Data Sync]
G --> H[UI Updates]
H --> I[User Feedback]
```
## Setup and Installation
1. Clone the repository
2. Open in Android Studio (Giraffe or newer recommended)
3. Sync Gradle dependencies
4. Build the project using:
```bash
./gradlew clean build
```
5. Install the generated APK from `app/build/outputs/apk/release/`
## Project Structure
```
app/
├── src/
│ ├── main/
│ │ ├── java/
│ │ │ └── com/example/fitnesstracker/
│ │ │ ├── activities/
│ │ │ ├── adapters/
│ │ │ ├── models/
│ │ │ ├── services/
│ │ │ └── utils/
│ │ ├── res/
│ │ │ ├── layout/
│ │ │ ├── values/
│ │ │ └── drawable/
│ │ └── AndroidManifest.xml
│ └── test/
└── build.gradle
```
## Key Components
### WorkoutSession
- Manages exercise flow
- Handles countdown and exercise timers
- Processes user interactions
- Updates progress UI
### Profile Management
- User data storage
- Theme preferences
- Progress tracking
- Achievement system
### Exercise Library
- Exercise categories
- Detailed instructions
- Custom workout creation
- Progress tracking
## Theme Support
- Light and Dark theme
- Material Design components
- Consistent styling
- Adaptive layouts
## Performance Considerations
- Efficient timer implementation
- Optimized data storage
- Responsive UI updates
- Battery-friendly background services
## Future Enhancements
- Heart rate sensor integration
- Cloud data sync
- Social features
- Advanced analytics
## Contributing
1. Fork the repository
2. Create a feature branch
3. Commit changes
4. Push to the branch
5. Open a Pull Request