https://github.com/ganainy/gym_masters_kotlin_compose

Social fitness app for Android using Jetpack Compose, Kotlin, Firebase (Firestore), MVVM, Hilt, and Room.
https://github.com/ganainy/gym_masters_kotlin_compose

android android-app coroutines exercise-library firebase firebase-auth firebase-storage firestore fitness-app flow hilt jetpack-compose kotlin mobile-app mvvm offline-caching retrofit2-kotlin room workout-tracker

Last synced: 5 months ago
JSON representation

Social fitness app for Android using Jetpack Compose, Kotlin, Firebase (Firestore), MVVM, Hilt, and Room.

Host: GitHub
URL: https://github.com/ganainy/gym_masters_kotlin_compose
Owner: ganainy
Created: 2024-08-05T16:47:08.000Z (about 1 year ago)
Default Branch: feed-node
Last Pushed: 2025-04-29T19:06:48.000Z (5 months ago)
Last Synced: 2025-04-29T20:20:36.069Z (5 months ago)
Topics: android, android-app, coroutines, exercise-library, firebase, firebase-auth, firebase-storage, firestore, fitness-app, flow, hilt, jetpack-compose, kotlin, mobile-app, mvvm, offline-caching, retrofit2-kotlin, room, workout-tracker
Language: Kotlin
Homepage:
Size: 5.97 MB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# Gym Masters

## Overview

The application manages various data types including user profiles, posts, comments, exercises, workouts, likes, and social connections. It employs a hybrid approach using:

1. **Cloud Firestore:** Primary remote NoSQL database for dynamic, structured data like user information, posts, comments, likes, follows, workouts, and hashtags. Used for real-time updates where needed.
2. **Firebase Authentication:** Handles user authentication (signup, sign-in, session management).
3. **Firebase Storage:** Stores user-uploaded media like profile pictures, post images, and workout cover images.
4. **Room Database:** Local persistence library for:
* Caching large datasets fetched initially (Exercises, Body Parts, Equipment, Targets).
* Managing offline data or user-specific saves (Saved Workouts, Saved Exercises - based on flags/tables).
* Handling optimistic UI updates and synchronization for actions like Likes (`CachedLike` table).
5. **External API (ExerciseDB):** Used by `ExerciseRepository` to fetch the initial, comprehensive list of exercises during first app launch.

> **Note:** On instruction on how to setup the Firebase project, please refer to the [Firebase Project Setup](PROJECT_SETUP.md).

> **Note:** To get a better understanding of how app and database is structured, please refer to [App Structure](APP_STRUCTURE.md).

## App Feature Showcase

This section highlights some of the core features of the Gym Masters app.

### 1. User Authentication
- Sign In to access your account.