Medicine Expiry Tracker Android App with Family Profiles

Medicine Expiry Tracker is an Android app that stops families from consuming expired medicines. In most Indian households, strips of tablets accumulate in drawers and kitchen shelves, and nobody remembers which strip expires when — especially when one person manages medicines for parents or grandparents. Existing reminder apps track doses but ignore expiry dates entirely, and none of them separate one family member's stock from another's, so a parent's insulin sits in the same list as a child's vitamins. This project solves exactly that: each family member gets a private profile, every medicine is stored with its batch number and expiry date in a local Room database, and a WorkManager background worker scans for approaching expiries on a 15-minute cadence and raises local notifications — red for expired, amber for due within 30 days. The dashboard sorts everything by days-to-expiry, so the most dangerous strip is always at the top.

End to end, the app works like this. When a strip is bought, the user opens the add-medicine form, types the name, batch number and the expiry date printed on the strip, picks which family member it belongs to, and saves — the entry lands in that member's table in the local Room database. Independently of the UI, Android's WorkManager fires a periodic worker on its minimum 15-minute interval; the worker queries the database for medicines that expired or will expire within the alert windows, and hands any hits to the NotificationManager, which posts them through the expiry-critical or expiry-watch channel. Opening the app shows the dashboard, which reads the same database, computes days-to-expiry from today's date, sorts the list with the most urgent first, and color-codes each row. Tapping "use one" decrements quantity in the database; deleting a finished strip removes it. No network call happens at any step — the phone is the entire backend.

1. The user adds a medicine — name, batch number, expiry date from the strip, family member, quantity and dosage note — saved to that member's table in the Room database.
2. The dashboard loads the active profile's medicines, computes days-to-expiry against today's date, and sorts the list with expired and nearest-expiry items first.
3. Each row is color-coded — red for expired or ≤7 days, amber for ≤30 days, green beyond — with an explicit "Expired 12d ago" or "5 days left" label.
4. Independently, a WorkManager periodic worker wakes on Android's 15-minute minimum interval and scans the database for newly expired or newly due medicines.
5. Hits are posted as local notifications through two channels — expiry-critical (expired, ≤7 days) and expiry-watch (≤30 days) — even if the app is closed.
6. The user acts: "use one" decrements quantity, delete removes finished strips, and the alerts screen keeps a history of every check the worker ran.

Tech stack:

• Kotlin (primary app language)
• Room · SQLite local database
• WorkManager background checks
• Material 3 UI components
• MVVM · ViewModel + StateFlow
• DataStore preferences
• Android Notification Manager
• Gradle build system

Four capabilities carry this project. First, family profiles: every member — self, parents, grandparents — gets an isolated medicine list with their own urgency counts, so one person's stock never pollutes another's. Second, expiry-first sorting: the dashboard orders every strip by days-to-expiry with a red-amber-green urgency code, putting expired and nearly-expired medicines at the top where they cannot be missed. Third, honest background checks: a WorkManager periodic worker re-scans the local database on Android's own 15-minute minimum cadence — the app never pretends to watch to the second — and posts local notifications through dedicated alert channels. Fourth, batch-level tracking: each entry records batch number, quantity and dosage note, and a one-tap "use one" action decrements stock so refills can be planned before a strip runs out. Together these four make the app genuinely useful in a real household, not just a demo.

• [Family profiles] Each family member gets a separate medicine list with independent urgency counts and a one-tap profile switcher in the app bar — one phone can manage medicines for the whole household.
• [Expiry-first dashboard] Every medicine is sorted by days-to-expiry with red (expired or ≤7 days), amber (≤30 days) and green (>30 days) urgency coding, so the riskiest strip is always at the top.
• [WorkManager background checks] A periodic worker re-scans the Room database on Android's 15-minute minimum interval and posts local notifications — no server, no account, works fully offline.
• [Batch and stock tracking] Each entry stores batch number, quantity and a dosage note; the "use one" action decrements stock and warns when a strip runs out.
• [Smart alerts screen] Expired, due-this-week and due-this-month items are grouped with plain-language guidance ("discard, do not consume"), plus a manual "run check now" option.
• [Search and filters] Instant search across medicine names and batch numbers, with filter chips for expired, due-in-7-days, due-in-30-days and safe stock.
• [Private by design] All data lives in the on-device Room database; nothing is uploaded, synced or tracked, which the report documents as an explicit privacy guarantee.

• Complete Kotlin source code with MVVM structure
• Room database schema and DAO layer
• WorkManager expiry-check worker implementation
• Signed-APK build guidance document
• Project report PDF (problem, design, implementation, testing)
• PPT presentation for final review
• Viva Q&A preparation document
• The working HTML demo used for the screenshots, as a clickable reference