Skip to content

About

A mobile application for managing daily milk purchases, tracking quantity and amount, and monitoring payment status.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

ย 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿฅ› Milk Manager

Milk Manager is a React Native mobile application designed to help households manage their daily milk purchases easily and efficiently.

The application allows users to record daily milk quantity, purchase amount, date, and time. It reduces the need for manual calculations by automatically tracking total milk quantity, total amount, and payment status.


๐Ÿ“ฑ Overview

People who purchase milk regularly may need to maintain daily records of:

  • Milk quantity
  • Daily amount
  • Purchase date
  • Purchase time
  • Total quantity
  • Total amount
  • Paid amount
  • Pending amount

Maintaining these records manually can be time-consuming and may lead to calculation errors.

Milk Manager provides a simple mobile solution for recording and monitoring these details in one place.


๐ŸŽฏ Project Objective

The main objective of Milk Manager is to simplify daily milk purchase management.

The application helps users:

  • Record daily milk purchases
  • Track the quantity of milk purchased
  • Track the amount spent
  • Automatically calculate totals
  • Monitor paid and unpaid amounts
  • Review previous milk purchase records

โœจ Features

๐Ÿฅ› Daily Milk Entry

Users can add their daily milk purchase details, including:

  • Milk quantity in liters
  • Amount
  • Date
  • Time

๐Ÿ’ฐ Amount Tracking

The application keeps track of the amount spent on milk purchases.

Users can view:

  • Daily amount
  • Total amount
  • Paid amount
  • Pending amount

๐Ÿ“Š Milk Quantity Tracking

Milk Manager records the quantity of milk purchased and helps users monitor the total quantity over a selected period.

For example:

Day 1 โ†’ 1.0 L
Day 2 โ†’ 1.5 L
Day 3 โ†’ 1.0 L
Day 4 โ†’ 2.0 L

Total โ†’ 5.5 L

๐Ÿงฎ Automatic Calculation

Instead of manually calculating the total quantity and amount, the application performs the required calculations automatically.

This helps reduce:

  • Manual calculation
  • Calculation mistakes
  • Paper-based record keeping

๐Ÿ’ณ Payment Monitoring

Users can monitor how much money has been:

  • Paid
  • Not paid
  • Remaining

This makes it easier to identify pending payments.


๐Ÿ“… Purchase History

Users can view previously recorded milk purchase information and track their daily records over time.


๐Ÿ“ฑ Mobile Application

Milk Manager is developed as a React Native mobile application, allowing it to provide a mobile-focused experience.


๐Ÿ› ๏ธ Technologies Used

Application

  • React Native
  • JavaScript

Development Tools

  • Visual Studio Code
  • Android Studio
  • Node.js
  • npm
  • Git
  • GitHub

Add any additional libraries, database technologies, or services that are actually used in your project.


๐Ÿ—๏ธ Application Workflow

                    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                    โ”‚      User        โ”‚
                    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                             โ”‚
                             โ–ผ
                  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                  โ”‚   Add Milk Entry    โ”‚
                  โ”‚                     โ”‚
                  โ”‚ Quantity            โ”‚
                  โ”‚ Amount              โ”‚
                  โ”‚ Date & Time         โ”‚
                  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                             โ”‚
                             โ–ผ
                  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                  โ”‚   Store Record      โ”‚
                  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                             โ”‚
                             โ–ผ
                  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                  โ”‚ Automatic           โ”‚
                  โ”‚ Calculations        โ”‚
                  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                             โ”‚
              โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
              โ–ผ              โ–ผ              โ–ผ
        Total Milk       Total Amount    Payment Status
         Quantity

๐Ÿ“‚ Project Structure

The exact structure may vary depending on the implementation.

A typical structure is:

milk-manager/
โ”‚
โ”œโ”€โ”€ android/
โ”œโ”€โ”€ ios/
โ”‚
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ components/
โ”‚   โ”œโ”€โ”€ screens/
โ”‚   โ”œโ”€โ”€ services/
โ”‚   โ””โ”€โ”€ ...
โ”‚
โ”œโ”€โ”€ assets/
โ”‚
โ”œโ”€โ”€ App.js
โ”œโ”€โ”€ package.json
โ”œโ”€โ”€ package-lock.json
โ”œโ”€โ”€ .gitignore
โ””โ”€โ”€ README.md

๐Ÿš€ Getting Started

Prerequisites

Before running the project, install:

  • Node.js
  • npm
  • React Native development environment
  • Android Studio
  • Android SDK
  • Java/JDK
  • Git

For Android development, make sure your Android emulator or physical Android device is properly configured.


๐Ÿ“ฅ Installation

1. Clone the Repository

git clone YOUR_GITHUB_REPOSITORY_URL

Go into the project directory:

cd milk-manager

2. Install Dependencies

npm install

3. Start the Application

If the project uses React Native CLI:

npx react-native start

Open another terminal and run:

npx react-native run-android

Use the commands that match your actual React Native project setup.


๐Ÿ“ฑ Running on a Physical Android Device

  1. Enable Developer Options on your Android device.
  2. Enable USB Debugging.
  3. Connect the device to your computer.
  4. Verify the device:
adb devices
  1. Start the application:
npx react-native run-android

๐Ÿ–ผ๏ธ Screenshots

Add screenshots of the application here.

Home Screen

![Milk Manager Home](screenshots/home.png)

Add Milk Entry

![Add Milk Entry](screenshots/add-milk.png)

Purchase History

![Purchase History](screenshots/history.png)

Payment Tracking

![Payment Tracking](screenshots/payment.png)

Recommended folder:

screenshots/
โ”œโ”€โ”€ home.png
โ”œโ”€โ”€ add-milk.png
โ”œโ”€โ”€ history.png
โ””โ”€โ”€ payment.png

๐Ÿ’ก Example Usage

A user purchases milk every day.

For example:

Date Milk Amount Status
Day 1 1 L โ‚น50 Paid
Day 2 1.5 L โ‚น75 Paid
Day 3 1 L โ‚น50 Pending
Day 4 2 L โ‚น100 Paid

The application can calculate:

Total Milk = 5.5 L

Total Amount = โ‚น275

Paid Amount = โ‚น225

Pending Amount = โ‚น50

This allows the user to quickly understand their milk purchase and payment status.


๐Ÿ” Data & Privacy

The application may store information related to milk purchases.

Do not include private or sensitive user data in the GitHub repository.

For example, avoid uploading:

.env
Private credentials
API keys
Passwords
Private databases
Personal customer information
Private backup files

Use sample/demo data when screenshots or demonstration data are required.


๐ŸŽฏ Benefits

Milk Manager provides several benefits:

  • Reduces manual record keeping
  • Reduces calculation errors
  • Saves time
  • Provides organized purchase history
  • Makes payment tracking easier
  • Provides quick access to daily records
  • Offers a simple mobile experience

๐Ÿ”ฎ Future Improvements

Possible future improvements include:

  • โ˜๏ธ Cloud data synchronization
  • ๐Ÿ‘ฅ Multiple milk supplier management
  • ๐Ÿ“Š Monthly and yearly reports
  • ๐Ÿ“ˆ Purchase analytics
  • ๐Ÿ”” Payment reminders
  • ๐Ÿ“„ PDF report generation
  • ๐Ÿ“Š Excel/CSV export
  • ๐Ÿ’พ Data backup and restore
  • ๐Ÿ” User authentication
  • ๐ŸŒ Multi-language support
  • ๐ŸŒ“ Dark mode
  • ๐Ÿ“ฑ Improved tablet support

๐Ÿ“Œ Project Status

Completed โœ…

Milk Manager has been developed as a React Native mobile application for managing daily household milk purchases and payment information.


๐Ÿ‘จโ€๐Ÿ’ป Developer

Tamilselvan

Software Developer


โญ Acknowledgement

Thank you for visiting the Milk Manager project.

If you find this project useful, consider giving the repository a โญ on GitHub.

About

A mobile application for managing daily milk purchases, tracking quantity and amount, and monitoring payment status.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages