The Tiffin Calculator is an Android application built using Kotlin, Jetpack Compose, and Firebase. The app helps users calculate the completion date of their tiffin services based on missed meals (morning and evening) over a selected month. It allows users to input the number of missed meals and select a starting date, dynamically calculating the date of service completion while accounting for the number of days in each month, including leap years.
Welcome to the Tiffin Calculator—a smart and simple Android app designed to calculate the completion date of your tiffin service based on missed meals. Built with Kotlin, Jetpack Compose, and Firebase, the app dynamically calculates how missed morning and evening meals affect your tiffin service duration, helping you keep track of when your service will end.
-
📅 Date Selection
Easily pick your start date using a Date Picker, giving you control over when your tiffin service begins. -
🍽️ Missed Meal Input
Input the number of missed morning and evening meals to get a personalized calculation for your service's completion date. -
📆 Month Selection
Select the month from a dropdown, with the app intelligently considering the number of days (including leap years) in each month. -
📊 Completion Date Calculation
Get real-time feedback on your estimated tiffin service completion date based on the number of missed meals and selected month. -
💾 Firebase Integration
While the app currently offers local date calculations, it’s integrated with Firebase for potential extensions—enabling data storage and retrieval for future features like user data or service history.
-
MainActivity.kt
This is the main entry point of the app, where the UI is crafted using Jetpack Compose for a seamless, modern experience. -
TiffinCalculatorComposable
The heart of the app where users input their start date, missed meals, and month to get the estimated completion date. -
DatePickerDialog
Provides a clean and intuitive interface for selecting the start date of your tiffin service. -
Firebase Backend
Though lightly integrated at the moment, the Firebase backend is set up for future expansions, enabling features like user-specific data management.
- Kotlin: Core programming language used for Android development.
- Jetpack Compose: Used to build an intuitive, smooth, and reactive user interface.
- Firebase: Integrated to handle backend operations like storing and retrieving user data.
- Android Studio: The IDE used for building and running the project.
- Android Studio: Ensure you have Android Studio installed on your machine. You can download it here.
- Firebase Setup: Follow the steps in the Firebase Docs to connect Firebase to your app.
- Clone the repository:
git clone https://github.com/yourusername/tiffin-calculator.git
Open the project in Android Studio:
cd tiffin-calculator
Connect Firebase:
Add your google-services.json file (Firebase project configuration) to the app directory. Build and Run:
Select Build > Make Project to compile the app. Run the app on an emulator or a connected Android device by clicking the Run button. 📲 Usage Pick the start date for your tiffin service using the Date Picker. Input missed meals—both morning and evening. Select the month to calculate the number of days. Get the estimated completion date based on your inputs and missed meals! 🗂️ Available Units and Calculations Missed Meals (Morning/Evening): Users can input individual counts for morning and evening meals missed. Month Consideration: Includes 30/31 days for most months, with special logic for February and leap years. 🤝 Contributing We welcome contributions! Feel free to fork this repository, open issues, or submit pull requests for improvements, bug fixes, or adding new features. Let's make the Tiffin Calculator even better together!
📜 License This project is licensed under the MIT License. For more details, see the LICENSE file.
Smart. Simple. Accurate. The Tiffin Calculator—your essential companion for managing tiffin service dates! 🍽️📅
This description uses a visually appealing format, providing detailed information about the app's features, project structure, and how to get started. It also invites contributions and highlights potential expansions via Firebase integration. You can modify the repository URL, screenshot links, and any additional information as needed.