Ratio - A calorie tracker

Summary

Ratio is a Kotlin Multiplatform Project with shared UI in Compose that targets both iOS and Android devices.

Description

It's an app that users can use to find out their recommended PFC and calories intake based on several fatcors such as age, weight, activity level, height, intended goal and gender. It take's into account all these factors to generate their recommended daily PFC, calorie and water intake. Users can log their create meals, which comprises of various food items that make up that meal. Tired of having to measure your food before logging?, Ratio allows you to log food for meals just by specifying the size in any context; 'A can of coke', '3 small hard boiled eggs', '3 medium sized cupcakes', while also still being able to specify the size (in grams) if you're feeling picky; '230g of whole wheat bread' and so on. Users can as well find great recipes their nutritional information as well as share links to your friends or find out more information about them. 'Reports' allows users to log their weights and get a comprehensive graph of their weight journey as well. Users can also modify their PFC and Calories manually as they see fit.

Demo

Android

demo-android.mp4

iOS

demo-ios.mp4

Modules

• commainMain:
  • contains all the shared code between the platforms
• android:
  • contains the android app
• iosMain:
  • contains the ios app

Data sources

• Edamam Recipe API | Link
• Calorie Ninjas API | Link

Built with

• Kotlin Multiplatform
• Compose Multiplatform
• DataStore
• Koin
• ViewModel
• Room
• Coil
• Koala Plot
• Kotlinx.datetime
• Kotlinx.serialization
• Ktor
• SQLite KMP

🛠️ Set up 🛠️

To run this application you would need;

Notice You would need a Mac with macOS installed to write and run iOS-specific code on simulated or real devices. This is an Apple requirement.

• Stable internet connection
• Machine running macOS
• Android Studio & Xcode installed
• The Kotlin Multiplatform plugin

Getting things ready.

• Clone this repo:

    git clone https://github.com/AdrianIkeaba/Ratio_Tracker

Android

1. Open the folder in Android Studio, and wait for all dependencies to be installed.
2. Create a new emulator if you haven't already Create an emulator.
3. In your configurations list select composeApp.
4. Select your preferred virtual device and click Run
5. To run on a physical Android device, enable Wireless debugging or USB debugging. More info here

iOS

In Android Studio

1. In the list of configurations select iosApp and Run, if it doesn't exist, select Edit Configurations:
2. Navigate to iOS Application | iosApp.
3. In the Execution target list, select your target device and click OK:
4. The iosApp run configuration is now available. Click Run next to your virtual device:

In Xcode

1. Click on Open existing project
2. Navigate to the cloned project location, open the folder and select the sub-folder iosApp
3. If you don't have an iOS simulator, Set up one
4. Click on the ▶ button in the top left corner to build and run the the iOS target app.