Tasteful (Android)

A Kotlin + Jetpack Compose Android app for managing recipes and a shopping list.

Features

• Recipe CRUD with Room
• Shopping list + reminders (WorkManager, notifications)
• Camera/gallery import with FileProvider
• Optional Firebase (Auth, Firestore, Storage)
• Compose UI, Navigation, Material 3

Tech stack

• Kotlin, Coroutines
• Jetpack: Compose, Navigation, ViewModel, Room, WorkManager
• Coil image loading
• Firebase (optional)

Structure

app/src/main/java/com/example/Tasteful/
  data/  viewmodels/  repository/  screens/  navigation/
  notifications/  provider/  utils/  firebase/

Prerequisites

• Android Studio Koala+ (Gradle 8.2.2 compatible)
• Android SDK 34, JDK 11

Setup

1. Clone

git clone https://github.com/<your-username>/Tasteful.git
cd Tasteful

2. (Optional) Firebase

• Create a Firebase project and Android app with package com.example.Tasteful (or your own).
• Download google-services.json into app/google-services.json (not committed).
• Use app/google-services.example.json as a reference.

Build

• Android Studio: Sync then run app.
• Terminal:

./gradlew assembleDebug

Tests

./gradlew testDebugUnitTest connectedDebugAndroidTest

CI

GitHub Actions workflow builds on push/PR.

Security

• app/google-services.json is ignored. Do not commit secrets.

License

MIT — see LICENSE.