|
1 | | -This is a Kotlin Multiplatform project targeting Android, iOS. |
| 1 | +# 💪 EvolveFit |
2 | 2 |
|
3 | | -* `/composeApp` is for code that will be shared across your Compose Multiplatform applications. |
4 | | - It contains several subfolders: |
5 | | - - `commonMain` is for code that’s common for all targets. |
6 | | - - Other folders are for Kotlin code that will be compiled for only the platform indicated in the folder name. |
7 | | - For example, if you want to use Apple’s CoreCrypto for the iOS part of your Kotlin app, |
8 | | - `iosMain` would be the right folder for such calls. |
| 3 | +<div align="center"> |
9 | 4 |
|
10 | | -* `/iosApp` contains iOS applications. Even if you’re sharing your UI with Compose Multiplatform, |
11 | | - you need this entry point for your iOS app. This is also where you should add SwiftUI code for your project. |
| 5 | + |
12 | 6 |
|
| 7 | +**🏋️ A comprehensive gym tracking app built with Kotlin Multiplatform** |
| 8 | +*Track workouts • Monitor progress • Achieve your fitness goals* |
13 | 9 |
|
14 | | -Learn more about [Kotlin Multiplatform](https://www.jetbrains.com/help/kotlin-multiplatform-dev/get-started.html)… |
| 10 | +[](https://kotlinlang.org) |
| 11 | +[](https://www.jetbrains.com/compose/) |
| 12 | +[](LICENSE) |
| 13 | +[](https://github.com/Cairo-Squad/EvolveFit/graphs/contributors) |
| 14 | + |
| 15 | +</div> |
| 16 | + |
| 17 | +--- |
| 18 | + |
| 19 | +## 🏗️ Architecture & Technology Stack |
| 20 | + |
| 21 | +<div align="center"> |
| 22 | + |
| 23 | +**Built with modern technologies for optimal performance** |
| 24 | + |
| 25 | +</div> |
| 26 | + |
| 27 | +### 🔧 Core Technologies |
| 28 | +``` |
| 29 | +🎯 Kotlin Multiplatform (KMP) 📱 Compose Multiplatform |
| 30 | +🗄️ Room Database 🔗 Koin Dependency Injection |
| 31 | +🖼️ Coil Image Loading 🌐 Ktor Networking |
| 32 | +🧭 Type-Safe Navigation 2 |
| 33 | +``` |
| 34 | + |
| 35 | +--- |
| 36 | + |
| 37 | +## ✨ Features Overview |
| 38 | + |
| 39 | +### 🚀 **OnBoarding Experience** |
| 40 | +<div align="center"> |
| 41 | +<img width="300" height="600" alt="OnBoarding Screen" src="https://github.com/user-attachments/assets/f0351615-99cd-4202-9f9b-2622c7917d02" /> |
| 42 | +</div> |
| 43 | + |
| 44 | +### 🔐 **Seamless Authentication** |
| 45 | +<div align="center"> |
| 46 | +<img width="250" height="540" alt="Registration Step 1" src="https://github.com/user-attachments/assets/755ed781-e893-457f-ab76-9a3582237834" /> |
| 47 | +<img width="250" height="540" alt="Registration Step 2" src="https://github.com/user-attachments/assets/04af8d4b-b00c-4c84-b9b5-dacf7fd44faf" /> |
| 48 | +<img width="250" height="540" alt="Registration Step 3" src="https://github.com/user-attachments/assets/72c1126c-b126-4a88-954e-ba44307ee784" /> |
| 49 | +</div> |
| 50 | + |
| 51 | +### 🏠 **Smart Home Dashboard** |
| 52 | +<div align="center"> |
| 53 | +<img width="300" height="600" alt="Home Screen" src="https://github.com/user-attachments/assets/1405881a-5f36-4dcb-9f04-2ebc75f9ed4b" /> |
| 54 | +</div> |
| 55 | + |
| 56 | +> **🎯 Key Features:** |
| 57 | +> - **📊 Weekly Progress** - Visualize your workout journey over time |
| 58 | +> - **🍎 Today's Nutrition** - Monitor water intake and calorie consumption |
| 59 | +> - **✨ Personalized Workouts** - AI-curated routines tailored to your goals |
| 60 | +
|
| 61 | +--- |
| 62 | + |
| 63 | +## 🥗 Nutrition Tracking |
| 64 | + |
| 65 | +<div align="center"> |
| 66 | + |
| 67 | +**Complete nutrition management at your fingertips** |
| 68 | + |
| 69 | +<img width="250" height="540" alt="Nutrition Overview" src="https://github.com/user-attachments/assets/4b1dfa38-0593-444d-8515-7cdd153a06f5" /> |
| 70 | +<img width="250" height="540" alt="Add Meal" src="https://github.com/user-attachments/assets/59ef9705-181e-4d17-ae85-425dd410163f" /> |
| 71 | +<img width="250" height="540" alt="Water Tracking" src="https://github.com/user-attachments/assets/e14967c6-2d04-4885-8526-5594bd1e4a93" /> |
| 72 | + |
| 73 | +</div> |
| 74 | + |
| 75 | +### 🍽️ **Smart Meal Suggestions** |
| 76 | + |
| 77 | +<div align="center"> |
| 78 | + |
| 79 | +<img width="300" height="600" alt="Suggested Meals" src="https://github.com/user-attachments/assets/6f91196e-70db-4151-886d-f40c8ce81a7d" /> |
| 80 | + |
| 81 | +**📋 Detailed Meal Information** |
| 82 | + |
| 83 | +<img width="300" height="600" alt="Meal Details" src="https://github.com/user-attachments/assets/408e67c3-a73d-4201-9df4-0da81b5dfb15" /> |
| 84 | + |
| 85 | +</div> |
| 86 | + |
| 87 | +--- |
| 88 | + |
| 89 | +## 💪 Workout Management |
| 90 | + |
| 91 | +<div align="center"> |
| 92 | + |
| 93 | +**Your personal trainer in your pocket** |
| 94 | + |
| 95 | +</div> |
| 96 | + |
| 97 | +<table align="center"> |
| 98 | +<tr> |
| 99 | +<td align="center"> |
| 100 | +<img width="200" height="400" alt="Workout Home" src="https://github.com/user-attachments/assets/18a2acf4-9858-4361-8511-493e33703247" /> |
| 101 | +<br><b>📋 Workout Plans</b> |
| 102 | +</td> |
| 103 | +<td align="center"> |
| 104 | +<img width="200" height="400" alt="Exercise List" src="https://github.com/user-attachments/assets/b6e6b621-55e2-45e2-b868-43e38abe110d" /> |
| 105 | +<br><b>🏃 Exercise Library</b> |
| 106 | +</td> |
| 107 | +<td align="center"> |
| 108 | +<img width="200" height="400" alt="Exercise Details" src="https://github.com/user-attachments/assets/06d15897-bd7f-4446-922d-c934ba7c13ec" /> |
| 109 | +<br><b>📖 Exercise Guide</b> |
| 110 | +</td> |
| 111 | +</tr> |
| 112 | +<tr> |
| 113 | +<td align="center"> |
| 114 | +<img width="200" height="400" alt="Workout Progress" src="https://github.com/user-attachments/assets/78c19172-7618-4f32-aaec-eb1ce8b922c2" /> |
| 115 | +<br><b>📈 Progress Tracking</b> |
| 116 | +</td> |
| 117 | +<td align="center"> |
| 118 | +<img width="200" height="400" alt="Workout Timer" src="https://github.com/user-attachments/assets/597e3a1a-f190-46f7-883b-51dcd69e1ba6" /> |
| 119 | +<br><b>⏱️ Workout Timer</b> |
| 120 | +</td> |
| 121 | +</tr> |
| 122 | +</table> |
| 123 | + |
| 124 | +--- |
| 125 | + |
| 126 | +## 👤 Profile & Customization |
| 127 | + |
| 128 | +<div align="center"> |
| 129 | + |
| 130 | +**Personalize your fitness experience** |
| 131 | + |
| 132 | +</div> |
| 133 | + |
| 134 | +<table align="center"> |
| 135 | +<tr> |
| 136 | +<td align="center"> |
| 137 | +<img width="200" height="400" alt="Profile Menu" src="https://github.com/user-attachments/assets/a3c2ece1-a26c-42e0-b986-2eb0b582bff1" /> |
| 138 | +<br><b>⚙️ Settings Hub</b> |
| 139 | +</td> |
| 140 | +<td align="center"> |
| 141 | +<img width="200" height="400" alt="Profile Details" src="https://github.com/user-attachments/assets/fd3eca99-440c-4b84-8f67-4dd958667366" /> |
| 142 | +<br><b>👤 Profile Info</b> |
| 143 | +</td> |
| 144 | +<td align="center"> |
| 145 | +<img width="200" height="400" alt="Dark Theme" src="https://github.com/user-attachments/assets/22e10a4c-5cb1-404a-9299-aed19e95fb88" /> |
| 146 | +<br><b>🌙 Dark Theme</b> |
| 147 | +</td> |
| 148 | +<td align="center"> |
| 149 | +<img width="200" height="400" alt="Light Theme" src="https://github.com/user-attachments/assets/860e23d5-e406-4f5c-a3fe-bb4ea001f650" /> |
| 150 | +<br><b>☀️ Light Theme</b> |
| 151 | +</td> |
| 152 | +</tr> |
| 153 | +</table> |
| 154 | + |
| 155 | +--- |
| 156 | + |
| 157 | +## 🚀 Getting Started |
| 158 | + |
| 159 | +<div align="center"> |
| 160 | + |
| 161 | +**Ready to transform your fitness journey?** |
| 162 | + |
| 163 | +</div> |
| 164 | + |
| 165 | +### 📥 **Installation Steps** |
| 166 | + |
| 167 | +```bash |
| 168 | +# 1️⃣ Clone the repository |
| 169 | +git clone https://github.com/Cairo-Squad/EvolveFit.git |
| 170 | + |
| 171 | +# 2️⃣ Open in Android Studio |
| 172 | +# Launch Android Studio and open the project |
| 173 | + |
| 174 | +# 3️⃣ Configure environment |
| 175 | +# Add required parameters in local.properties file |
| 176 | + |
| 177 | +# 4️⃣ Build and run |
| 178 | +# Deploy to emulator or physical device |
| 179 | +``` |
| 180 | + |
| 181 | +--- |
| 182 | + |
| 183 | +## 🤝 Join Our Community |
| 184 | + |
| 185 | +<div align="center"> |
| 186 | + |
| 187 | +**Help us make fitness accessible for everyone!** |
| 188 | + |
| 189 | +[](CONTRIBUTING.md) |
| 190 | +[](https://github.com/Cairo-Squad/EvolveFit/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) |
| 191 | +[](https://discord.gg/your-discord) |
| 192 | + |
| 193 | +</div> |
| 194 | + |
| 195 | +### 🛠️ **How to Contribute** |
| 196 | + |
| 197 | +<div align="center"> |
| 198 | + |
| 199 | +```mermaid |
| 200 | +graph LR |
| 201 | + A[🍴 Fork] --> B[🌿 Branch] |
| 202 | + B --> C[💾 Commit] |
| 203 | + C --> D[📤 Push] |
| 204 | + D --> E[🎯 PR] |
| 205 | + style A fill:#FF6B6B |
| 206 | + style B fill:#4ECDC4 |
| 207 | + style C fill:#45B7D1 |
| 208 | + style D fill:#96CEB4 |
| 209 | + style E fill:#FFEAA7 |
| 210 | +``` |
| 211 | + |
| 212 | +</div> |
| 213 | + |
| 214 | +1. **🍴 Fork** the repository to your GitHub account |
| 215 | +2. **🌿 Create** your feature branch (`git checkout -b feature/amazing-feature`) |
| 216 | +3. **💾 Commit** your changes with descriptive messages |
| 217 | +4. **📤 Push** to your forked repository |
| 218 | +5. **🎯 Open** a Pull Request with detailed description |
| 219 | + |
| 220 | +--- |
| 221 | + |
| 222 | +## 👥 Meet Our Team |
| 223 | + |
| 224 | +<div align="center"> |
| 225 | + |
| 226 | +[](https://github.com/Cairo-Squad/EvolveFit/graphs/contributors) |
| 227 | + |
| 228 | +**💖 Made with passion by the Cairo Squad** |
| 229 | +*Dedicated developers revolutionizing fitness technology* |
| 230 | + |
| 231 | +</div> |
| 232 | + |
| 233 | +--- |
| 234 | + |
| 235 | +## 🌟 Show Your Support |
| 236 | + |
| 237 | +<div align="center"> |
| 238 | + |
| 239 | +**Love EvolveFit? Show us some love!** |
| 240 | + |
| 241 | +[](https://github.com/Cairo-Squad/EvolveFit) |
| 242 | +[](https://github.com/Cairo-Squad/EvolveFit/network) |
| 243 | +[](https://github.com/Cairo-Squad/EvolveFit/watchers) |
| 244 | + |
| 245 | +**⭐ Star this repository if it helped you on your fitness journey!** |
| 246 | + |
| 247 | +<br> |
| 248 | + |
| 249 | +*🚀 Evolving fitness technology, one commit at a time* |
| 250 | + |
| 251 | +<br> |
| 252 | + |
| 253 | +[](https://github.com/Cairo-Squad/EvolveFit) |
| 254 | +[](https://kotlinlang.org) |
| 255 | +[](https://en.wikipedia.org/wiki/Cairo) |
| 256 | + |
| 257 | +</div> |
0 commit comments