MedAssist

MedAssist is a lightweight Node.js web application for managing personal medication inventories, schedules, and reminders. It provides a simple dashboard for tracking doses, stock levels, and upcoming schedules, and can generate medication lists for travel periods.

Key Features

• Track medication inventory with counts, per-dose usage, and days-left calculations
• Define one or more schedules per medication (time of day, interval in days, start date)
• Automated email reminders for low supplies using configured SMTP settings
• Planner that generates required medication quantities for a selected date range
• Simple web dashboard showing upcoming schedules, reorder reminders, and medication overview
• Runs on SQLite for single-file storage and supports Docker / docker-compose deployment
• Lightweight single-process Node.js/Express app with cron-based scheduling for notifications

Use Cases

• Maintain a household medication inventory and receive reminders when supplies run low
• Prepare a packing list of medications and quantities needed for travel or extended absence
• Provide a quick reference dashboard to confirm whether a dose was likely taken based on expected stock

Limitations and Considerations

• No built-in authentication or access control in the current version; suitable primarily for single-user or local-network use
• Basic security model and not intended as a medical-grade system; verify all medical decisions with a healthcare professional
• Limited multi-user, prescription management, and integration features (planned features such as login, repeating prescriptions, and FHIR/Home Assistant support are noted but not yet implemented)
• Scalability is limited by single-file SQLite storage and single-process Node runtime

MedAssist is a pragmatic, hobbyist-built tool aimed at simplifying everyday medication tracking and reminders. It is best suited for individuals or families looking for a lightweight, self-hosted solution with straightforward deployment and SMTP-based notifications.