A native Android app built for a Mobile Development class, designed to help users track fridge inventory and reduce food waste.
AlwaysFresh is a smart digital fridge inventory tracker that classifies items by freshness, doubles as an auto-generated shopping list, and visualizes waste patterns over time. This project is a demonstration of modern Android architecture using Kotlin, MVVM, Room persistence, and reactive UI with Kotlin Flow.
AlwaysFresh_Demo.mp4
This application was designed around one question: "what's about to go bad, and what do I need to replace?"
| Feature | Description |
|---|---|
| Inventory Tracking | Add, edit, and remove food items with expiration dates, stored in a local Room database. |
| Freshness Classification | Each item is color-coded as Fresh, Expiring Soon (within 7 days), or Expired, computed live from the expiration date. |
| Auto Shopping List | Items you remove from inventory are soft-deleted and automatically populate a Shopping List — the things you just ran out of. |
| Waste Analytics | A dashboard summarizing how many items you consumed vs. let expire, to surface waste patterns. |
| Dark Mode | Per-user theme preference stored in SharedPreferences and applied at launch. |
| Responsive Layouts | Every screen has a dedicated landscape variant. The main screen swaps a BottomNavigationView (portrait) for a NavigationRail (landscape). |
This is an Android application, so the recommended workflow is through Android Studio with the Gradle Wrapper handling all dependencies automatically.
- Android Studio (Giraffe or newer recommended)
- Android SDK 36 with build-tools installed
- An Android emulator (API 35+) or a physical device in developer mode
- Clone the repository:
git clone https://github.com/NinyaDev/AlwaysFresh-App.git
- Open Android Studio →
File→Open→ select theAlwaysFresh-Appfolder. - Wait for the initial Gradle Sync to complete — this will auto-generate a fresh
local.propertiespointing to your local Android SDK and download all dependencies defined ingradle/libs.versions.toml. - Select an emulator (or connected device) from the device selector.
- Click the Run ▶ button (or
Shift + F10).
Troubleshooting:
If Gradle Sync fails with an SDK location error, go to File → Project Structure → SDK Location and confirm the Android SDK path is set. Android Studio will rewrite local.properties automatically after this.
| Layer | Technology |
|---|---|
| Language | Kotlin |
| Architecture | MVVM (AndroidViewModel + LiveData + Kotlin Flow) |
| UI | Material Components, ConstraintLayout, ViewBinding |
| Persistence | Room (SQLite) with KSP annotation processing |
| Navigation | Fragments, ViewPager2, BottomNavigationView / NavigationRail |
| Build | Gradle Kotlin DSL, Version Catalog (libs.versions.toml) |
AlwaysFresh-App/
├── app/
│ ├── src/main/
│ │ ├── java/com/example/alwaysfresh/
│ │ │ ├── data/ # Room entities, DAOs, AppDatabase
│ │ │ ├── model/ # Repository + domain logic (freshness classification)
│ │ │ ├── viewmodel/ # Shared MainViewModel (activityViewModels)
│ │ │ ├── adapter/ # RecyclerView + ViewPager2 adapters
│ │ │ ├── fragment/ # Inventory, Dashboard, ShoppingList, WasteAnalytics
│ │ │ └── *Activity.kt # MainActivity, AddItem, ItemDetail, Settings
│ │ └── res/
│ │ ├── layout/ # Portrait layouts
│ │ ├── layout-land/ # Landscape variants
│ │ ├── values/ # Strings, colors, themes (light)
│ │ └── values-night/ # Dark mode overrides
│ └── build.gradle.kts
├── gradle/
│ └── libs.versions.toml # Dependency version catalog
├── build.gradle.kts
├── settings.gradle.kts
├── .gitignore # Files and folders to be excluded from version control
└── README.md
This project is distributed under the MIT License. See the LICENSE file for more details.
Adrian Ninanya
- GitHub: NinyaDev
- Linkedin: Adrian Ninanya
- Project Link: https://github.com/NinyaDev/AlwaysFresh-App